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Front-end (Client) Links to Workflow Engine + Permissions Schema 

Background of the Invention 

Field of the Invention: 

This invention relates to the field of middleware which allows connection between 
clients and services on a server, and is particularly adapted to allowing non-proprietary front 
end clients or clients of other proprietary systems to interact efficiently with said server 
services. 

Background: 

The first application of this invention is in the field of publishing software 
services and systems where the company of the inventors has been active for a number of 
years, producing and selling a system called Hermes that supports the management of 
various items useful for publishing newspapers, particularly; text, pages, images, and 
charts. Due to the rise of small scale systems and particularly ones which use various 
other versions of software for working on some or all of these items, most notably Adobe 
InDesign and Adobe InCopy as well as QuarkExpress, many users are familiar and 
comfortable with using features of these programs for managing their use of these items 
and preparing them for publication. Therefore, even though our Hermes system has fine 
editors for handling such items, there has developed a need to accommodate such users. 

The Hermes system marinating a repository for manipulating, managing, sizing, 
layout, printing, and other related activities with respect to the items (charts, text, images, 
pages and the like), as do other proprietary publishing systems. Accordingly, a system 
and method for accomplishing such management and manipulation functions that accepts 
items formatted in a customer preferred front-end program is desirable. 

Further, with the rise of open standards such as HTTP, XML, and SOAP many of 
the characteristics of the data files for objects can be communicated about between pieces 
of software. However, a system has not heretofore been developed to makethis all work 
together in a commercially viable manner. 
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Summary of the Invention 

In order to allow the proprietary system (Hermes, in the preferred embodiment) to 
manage and manipulate items as objects, a set of metadata about these items is produced 
identifying a set of characteristics about them which allows them to be manipulated by 
the proprietary system. Further, the front end or client software through which the item 
was created is not affected, because we provide the data file of the item in an unmodified 
format back to the client software should further content manipulation be needed To 
accomplish this a metadata envelope is created around the item to make it into an object ' 
The envelope is described in SOAP/XML to define and enable handling of the object and 
HTTP(S) is used for its transmission. Additional meta data is used to identify the native 
format of the item. Thus, the envelope has HTTP and XML data, as well as SOAP data to 
define and enable handling of the object, and a data string is also created identifying the 
native format of the item. Accordingly, using software such as the Woodwing 
SmartConnection Pro to connect to clients InDesign and InCopy, a SOAP connector is 
provided which forwards the partially packaged object to the workflow engine and 
perm.ss.ons scheme (our Hermes editorial system) which completes the envelope and 
keeps track of what happens to the object inside of its own repository. Thus this 
m,ddleware operates like a web service, generating a format field and providing 
HTTP/XML/SOAP connections between the workflow engine/permissions schema and 
the client software. 

Brief Description of the Figures 

Various figures are included in the accompanying documents mad 6 a part hereof 
by this reference thereto. 

Detailed Description of the Preferred Embodiments 

While various embodiments of the present invention are described, it should be 
understood that they have been presented by way of example only, and not as a 
limitation. Thus, the breadth and scope of the present invention should not be limited by 



3 



any of the above-described exemplary embodiments, but should be defined only in 
accordance with the Claims that may issue herefrom and their equivalents. 

The first document describes the overall architecture. It is the design 
specification (8 pages) for the integration needed between Woodwing's SmartConnection 
and the Hermes SOAP Connector/Services middleware. 

Database Format Field Design Specification (7 pages) is a document identifying 
the format field characteristics needed for the invention. 

Hermes Connector Use Case Specification (23 pages) is a preferred embodiment 
description of use cases. 

The SOAP Application Server Design Specification (12 pages) describes a 
preferred embodiment design of the same. 

The SOAP Application Server Platform Specification (21 pages) describes a 
preferred embodiment design of the same. 

The Third Parties Integration with NewsRoom Design Specification (10 pages) 
describes a preferred embodiment design of the same. NewsRoom is a component of 
Hermes that may have counterparts in other similar workflow and permissions systems. 

The Integration Platform Project Supplementary Specification (8 pages) describes 
a prototype design of Hermes integration using HTTP and SOAP. 

The Database Format Field Project Functional Specification (7 pages) describes a 
preferred embodiment design of the same. 

The Adobe® Integration with eEditorial® Solutions Project Design Specification 
(39 pages) describes a preferred embodiment design of the same. 

A 26 page chart of iconography used in the preferred embodiment is also 
included. 

The Third Parties Integration with NewsRoom Project Functional Specification 
(10 pages) describes a preferred embodiment design of the same. 

The Workflow Definition for External Objects Project Functional Specification (9 
pages) describes a preferred embodiment design of the same. 

The ADOBE InDesign Integration with News Content Manager -Hermes 
document (17 pages) describes a preferred embodiment design of the same. 
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The Advanced Query in Third Party Applications Design Specification^ pages) 
describes a preferred embodiment design of the same. 

The Pages and Objects Management in External Applications Project Functional 
Specification (12 pages) describes a preferred embodiment design of the same. 

The Hermes Palette Availability in External Applications Project Functional 
Specification (9 pages) describes a preferred embodiment design of the same. 

The Third Parties Integration with Hermes Explorer Project Functional 
Specification (1 1 pages) describes a preferred embodiment design of the same. 

Thus, the invention has been described. 
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ABSTRACT 

Middleware ties together client front-end software that creates content items such 
as text editor files, image files, page files, and chart files in a manner that it can be used 
m conjunction with a workflow and repository management system even though both 
systems have different proprietary formats for such items. The items are packaged as 
objects with an envelope to allow for protocol handling (HTTP, XML and SOAP) n well 
as with metadata to allow for manipulation of the objects within the workflow and 
repository management system. The first application of this invention is to a large scale 
publishing system. 
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Technical design doc ument for milestone 4 
Features as described in this exhibit! 
3.1 -3.3 -3.9- 3.15 -4.3-4 fi 
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• Technical design document for milestone 5 

• Features a s described in this exhibit: 
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Milestone 6 

Bv date; 28 Mar 2QQ3 



Technical desi gn document for milestone 6 
* Final integration testing 
• — User, inst all! and config documentation 
• — Features a s described in this exhibit: 

• — Hermes Connector Versi on 1 released 
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The software developed under this contract wil l work properly under the following operating 
systems: 

1. Windows 2QQQ Professional 

2. Windo ws XP Profession^ 

3. MACOS X v1 0.7.x 

Migration to la ter revision s of these operating systems is discussed in Exhibit 4. 
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un,sys Propriety Database Format Field 

1 Scope 

1.1 Document Overview 

™abfse CUment d6SCribeS &e Ch ° iCe ofim P lementin S the format field on the 

JlSli 10 ?7 a ^ efe inte S ration ^ *M applications the Hermes 
database and chent applications need to be modified. 

1 .2 System Overview 

Third party applications store their content in Hermes by placing the native 
format file onto the file system. Hermes clients need to show the content of the 
pages and objects generated by such applications 

To achieve this goal, the third party application generates a preview of the 
page/object and Hermes stores it along with the native file 
The originating application is always able to reload the native file to modify it 
This operation can be completed by an external application via a SOAP call to 
retrieve the page / object. 

However the Hermes Explorer application need to perform operations such as 
searching for pages/objects of a particular format and showing the information 
relevant to me originator in the query result pane. °rmanon 

2 Referenced documents 

Official registered mime-types htt P ://www ian* om/assinnmpntg/moHio. 
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3 System design proposal 

It could be possible to store the information relevant to the originating 
application in the newsroom content field of the database (pages table) but in 
this way, whenever a query is executed to search for a page/object produced by 
the XX application the Hermes Explorer will be forced to open and scan the 
content blob field. 

For performances reason, this cannot be implemented. 

The proposed solution implies adding a string field in the pages table of the 
Hermes database to store the mime type of the application that creates the 
external page/content. 

The mime type will be used to uniquely identify the external application. For 
the user the mime type is not significant, so it will be mapped to a friendly 
name at run-time, according to the official mime type specification list 
maintained by IANA. 

As a consequence, some Hermes client applications and Hermes libraries need 
to be modified by taking into consideration the format field. These changes 
will be made only for the internal 7.0 version. 



3.1 Affected client applications 

Hermes Explorer needs to be changed. In particular, it must be possible to: 

• Search for a page/object by specifying the format in the search criteria 

• View the format field in the page query results list. 



3.2 Affected libraries 

Affected libraries are 

• Hrdbcore 

• Hrdbcli 

Both modules will allow performing the query by taking into consideration the 
new format field, too. 
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4 Performance 

4.1 Speed 

No degradation in speed due to the implementation of the system. 

4.2 Reliability, availability and 
maintainability 

No degradation in reliability, availability and maintainability due to the 
implementation of the system. ' ' 



4.3 Capacity 

No degradation in capacity due to the implementation of the system. 



Hermes Connector 
Use Case Specification 



Version 1.0 



Revision History 



Date [version 


Description 

— _ ... 


Author 


8 January 2003 jjl.O Draft jjnrst draft n 


JH 


13 January 2003 j 


Changes after review 


JH j 


E-H 


! 






r 





6WS7277 ^flSBSSS 



Table of Contents 



4. 



INDESIGN USE CASES 
1- Overview 

2. Login 

Basic Flow of Events 
Alternative Flows 

Login fails 
Preconditions 
Post conditions 
Sequence Diagram 

3. Logout 

Basic Flow of Events 
Preconditions 
Post conditions 
Sequence Diagram 

Save Page 

Basic Row of Events 
Alternative Flows 

Page not saved before or Save As 
Preconditions 
Post conditions 
Sequence Diagram 

Open Page 

Basic Row of Events 
Alternative Flows 

Page locked 
Preconditions 
Post conditions 
Sequence Diagram 

Release Page 

Basic Flow of Events 
Alternative Flows 

Release from query result 
Preconditions 
Post conditions 
Sequence Diagram 



5. 



7. 



Close Page 

Basic Flow of Events 
Alternative Flows 
Modified page 
Preconditions 
Post conditions 
Sequence Diagram 

Delete Page 

Basic Row of Events 
Alternative Rows 

Locked page 
Preconditions 
Post conditions 



2 
2 
2 
2 
2 
2 



3 
3 
3 
3 



3 
3 
3 
3 
3 
4 



4 
5 
5 
5 
5 
5 



5 
5 
5 
5 
6 
6 



6 
6 
6 
6 
7 
7 



7 
7 
7 
7 
7 



Sequence Diagram 

9. Assign Object 

Basic Row of Events 
Alternative Flows 
Preconditions 
Post conditions 
Sequence Diagram 

10. Check-in Object 

Basic Flow of Events 
Preconditions 
Post conditions 
Sequence Diagram 

1 1 - Checkout Object 

Basic Flow of Events 
Preconditions 
Post conditions 
Sequence Diagram 

12. Refresh Object 

Basic Flow of Events 
Preconditions 
Post conditions 
Sequence Diagram 

13. Release Object 

Basic Flow of Events 
Preconditions 
Post conditions 
Sequence Diagram 

14. Delete Object 

Basic Row of Events 
Alternative Rows 
Locked object 
Preconditions 
Post conditions 
Sequence Diagram 

15. Place Object 

Basic Flow of Events 
Alternative Flows 

Object already placed 
Preconditions 
Post conditions 
Sequence Diagram 

16. Detach Object 

Basic Flow of Events 
Preconditions 
Post conditions 
Sequence Diagram 

INCOPY USE CASES 

1. Overview 

2. Login 

Basic Row of Events 



Alternative Flows 

Login fails 16 

Preconditions 16 

Post conditions 17 

Sequence Diagram ^ 7 

17 



Logout 

Basic Flow of Events 

Preconditions 17 
Postconditions 17 



Open Object 



Release Object 



17 
18 

18 



Sequence Diagram 
Save Object 
Basic Flow of Events 

Alternative Flows 18 
New document ]* 
Preconditions 18 
Postconditions 18 
Sequence Diagram ^ 8 

19 

Basic Row of Events 

Alternative Rows 19 

Locked object ™ 

Preconditions 19 

Post conditions } 9 

Sequence Diagram ™ 

Close Object 20 

Basic Flow of Events 
Alternative Flows 

Opened object 2 ° 

Preconditions 20 

Post conditions 20 

Sequence Diagram 2 ° 



20 
21 

Basic Flow of Events 

Alternative Flows 21 
Opened object 2 J 
Locked object %] 
Preconditions 21 
Postconditions 21 
Sequence Diagram 2 ^ 

Delete Object 22 

Basic Flow of Events 

Alternative Flows 22 

Locked object 22 

Preconditions 22 

Post conditions 22 

Sequence Diagram ' 22 

23 



InDesign Use Cases 
1. Overview 



InDesign 




Figure 1: InDesign Use Cases 



2. Login 

This use case allows InDesrgn to log into the Hermes system. 

Basic Flow of Events 

1. The page designer, selects the Login action 

2. The system displays a login form 

3. The page designer enters login information 

4. The system sends a login request to the Hermes system 

Alternative Flows 

Login fails 

If the login request fails, the page designer is informed of the failure and is 
given the opportunity to re-enter login Information. 

Preconditions 

• The user is not logged in. 

Post conditions 

• The user is logged in; a session has been created. 
Sequence Diagram 



Hermes Conner 



Show Login form 



Login Form 



Hermes SQAP 





» 




T^I> Retrieve locations 

HemnesLoglnRequest 








HermesLoglnRequestResponse 








HennesGetUserDataRequest 








^HermesGetUserDataRequestResponsa * 




s 










1 




1 




1 
1 
1 





Figure 2: Login sequence 



3. Logout 

This use case allows InDesign to log out from the Hermes system. 
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Basic Flow of Events 

1. The page designer selects the Logout action 

2. The system sends a logout request to the Hermes system 

Preconditions 

• The user is logged in. 

Post conditions 

• The user has been logged out; 

• Hermes actions can no longer be performed. 



Sequence Diagram 



Hermes Connector 



Hernias SOAP 



HermesLogoutRequest 



KarmesLogoutRequestResponse 



Figure 3: Logout sequence 



4. Save Page 

This use case saves a Hermes page. 

Basic Flow of Events 

1. The page designer selects the Save action 

2. The system sends a request to the Hermes system 

Alternative Flows 

Page not saved before or Save As 

When page has not been created using New Hermes page, or when the 
page designer chooses the Save As action, the system displays a similar 
form as with New Hermes page use case. 

Preconditions 

• The page designer has been logged in. 

• A page is open and modified 

Post conditions 

• The page has been saved in the Hermes system. 

• The page remains open.r="t 
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Sequence Diagram 



Hermes Conner 



HermesSavePage 



Hermes SOAP 



Figure 4: Save page sequence 
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Save Page form 



Show Save page form 



<c 



Hermes SOAP 



HermesEnuin Levels 



Hermes EnurnEdltlons 



HermesEnumGrtds 



HermesCreatePage 



Figure 5: Save page sequence - alternative 



5. Open Page 

This retrieves a page from the Hermes system to edit it. 
Basic Flow of Events 

1 view 13996 desfgner se,ects the °P en action on a selected page in the 

2. The system sends a request to retrieve the page from the Hermes 
system 

3. The system opens the page. 



Alternative Flows 

Page locked 



When another user is editing the page, the page designer will informed 
that page is already in use and it will be opened read-only. 

Preconditions 

• The user has been logged in. 

• View contains InDesign pages. 

Post conditions 

• The page has been opened. 

• The page is locked in the Hermes system. 

Sequence Diagram 



Hermes nn nng g^ r 



HermesGetPage 



Hermes SOAP 









» 








Open page 






1 











Figure 6: Open page sequence 



6. Release Page 

This use case changes the status of the page. 
Basic Flow of Events 

1. The page designer selects the Release page action 

2. The system displays the Release page form 

3. The page designer selects the next status from a list of available 
statuses 

4. The system sends a request to change the status 

Alternative Flows 

Release from query result 

When the page designer uses the Query list to release a page, the page 
must not be locked. gjj 

Preconditions 

• The page designer has been logged in. 



• A Hermes page has been opened. 



Post conditions 

• The status of the page has been changed. 

• The document is closed. 

Sequence Diagram 



Hermes Connector 



Release p^m form 



Show Release page'action 



Hermes SOAR 



HermesGetNextValfdStatus 



HermesSavePage 



> Close document 
Figure 7: Release page sequence 
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7. Close Page 

This use case closes a Hermes page. 
Basic Flow of Events 

1. The page designer chooses the Close page action 

2. The system sends a unlock request to the Hermes system. 

Alternative Flows 



When the page Is modified, the page designer is asked if the changes 
should be saved. — 



Preconditions 

• The page designer has been logged in. 

• A page has been opened 
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Postconditions 

• The Hermes page Is unlocked. 

• The page has been closed. 

Sequence Diagram 



Hermes Connprtnr 



HermesUnlockPage 



Hermes SOAP 



i 



Figured 



& Delete Page 

This use case removes a Hermes page from the system. 

Basic Flow of Events 

3. The page designer selects a page 

4. The page designer chooses the Delete page action 

5. The system sends a delete request to the Hermes system. 

Alternative Flows 
Locked page 

When the page Is locked, the page cannot be deleted. 
Preconditions 

• The page designer has been logged in. 

• The page has not been locked. r=l 



Postconditions 

• The Hermes page has been deleted. 
Sequence Diagram 



Hermes Connector 



Hermes DeletePage 



Figure 9: Delete page sequence 
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9. Assign Object 

This use case creates a new Hermes InCopy object 

Basic F/oiv of Events 

1. The page designer selects the Assign object action. 

2. The system present the Assign form 

3. The page designer selects information 

4. The system sends a new object request to the Hermes system. 

5. The system sends a request to link the object to the page. 

Alternative Flows 

If an object with the specified name already exists, the system displays an 
error message and allows the page designer to change the name and 
resend the request. 

Preconditions 

• The page designer has been logged in. ' 

• The page is known in the Hermes system. 

• One or more stories have been selected r= 



Post conditions 

• A new InCopy object has been created. 

• The InCopy object not editable on the page 
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Sequence Diagram 



Hermes Connector 



Assign Ohfect form 



Show Assign Object i 



Henries SOAP 



<s 



HermesEnumLevels 



Hermes EnumEditions 



Hermes CrealeObject 



C 



HermesUnkObject 



S 



Figure 10: Assign object sequence 



10. Check-in Object 

This use case checks in an InCopy object linked to an InDesign page 

Basic Flow of Events 

1. The page designer selects the Save object action. 

2. The system shows the Save object form 

3. The page designer enters information 

4. The system sends a request to the Hermes system. 

Preconditions 

• Page designer has been logged in. 

• An InCopy object on a page has been selected. 

Post conditions 

• The InCopy object has been checked In and Is no longer editable on 
the page. 
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Sequence Diagram 




Figure 11: Save object sequence 



11. Check-out Object 

This use case checks out an object on an InDesign page. 
Basic Flow of Events 

1. The page designer chooses the Check-out object action 

2. The system sends a Get request to the Hermes system. 

3. The system refreshes the content of the page. 

4. The system makes the Item on the page editable. 

Preconditions 

• The page designer has been logged in. 

• An object has been selected. 

• The object has not been locked. 

Post conditions 

• The object has been refreshed. 

• The object is locked. 
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Sequence Diagram 




Figure 12: Check-out object sequence 



12. Refresh Object 

This use case refreshes an object on an InDesign page} 

Basic Flow of Events 

1. The page designer chooses the Load object action 

2. The system sends a Load request to the Hermes system. 

3. The system refreshes the content of the page. 

Preconditions 

• The page designer has been logged in. 

• An object has been selected. 

• The object has not been locked. 

Postconditions 

• The object has been refreshed. 

• The object Is locked. 

Sequence Diagram 



Hermes Connector 



Hermes SOAP 



HenrtesGetObject 



i 
i 



Refresh (tern 



Figure 13: Refresh object sequence 
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13. Release Object 

This use case changes the status of the object. 
Basic Flow of Events 

1. The page designer selects the Release object action. 

2. The system shows the Release object form. 

3. The page designer enters the needed information. 

4. The system sends a request to the Hermes system. 

Preconditions 

• The page designer has been logged in. 

• An object has been selected. 

Post conditions 

• The object's status has been changed. 



Sequence Diagram 



Hermes Connector 



ReteasoQplectform 



Show Release object action 



S 



Lock item 



Hetmes SOAP 



HermesGetNextValldStatus 



HermesSaveObject 



Figure 14: Release object sequence 



14. Delete Object 

This use case removes a Hermes object from the system. 

Basic Flow of Events 

1. The page designer selects an object 

2. The page designer chooses the Delete object action 

3. The system sends a delete request to the Hermes system. 
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Alternative Flows 

Locked object 



When the object is locked, the object cannot be deleted. 
Preconditions 

• The page designer has been logged In. f=E 
Post conditions 

• The Hermes object has been deleted. 



Sequence Diagram 



Hermes Cgnnector 



HermQs SQAP 



{ HermesDeleteObject j 
: * - 



I 

Figure 15: Delete object sequence 

15. Place Object 

This use case places an object onto a page 

Basic Flow of Events 

1. The page designer selects an object. 

2. The page designer chooses the place action. 

3. The system sends a Load object request. 

4. The system places the object. 

5. The system sends a Link request. 

Alternative Flows 

Object already placed , 



If an object has already been linked to a page and cannot be linked to 
multiple pages, the linking fails. 



Preconditions 

• The page designer has been logged in 

• A Hermes page has been opened. 
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Post conditions 

• The object has been placed. 

• The object has been linked to the page. 

Sequence Diagram 



Hermes Connector 



Hermes §qap 



HermesGetObject 



Place object 



HermesLinkObject 



HermesSavePage 



Figure 16: P/ace object sequence 

16. Detach Object 

This use case removes the link between an object and a page. 

Basic Flow of Events 

1. The user selects the Detach action. 

2. The system sends an Unlink request. 

Preconditions 

• The page designer has been logged In. 

• An object has been selected. 

Post conditions 

• The object has been detached. r=| 



Sequence Diagram 
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Hermes Connector 



HermesUnltnkObject 



CF 



Hermes SOAP 



Figure 17: Detach object sequence 
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1. Overview 
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Figure 18: InCopy Use Cases 



2. Login 

This use case allows InCopy to log into the Hermes system. 

Basic Flow of Events 

1. The editor selects the Login action 

2. The system displays a login form 

3. The editor enters login information 

4. The system sends a login request to the Hermes system 

Alternative Flows 

Login fails 

If the login request fails, the editor is Informed of the failure and is given 
the opportunity to re-enter login information. 



Hermes Connector Use Cases Specification 
Page 16 



Preconditions 

• The editor is not logged in. 

Post conditions 

• The editor is logged in; a session has been created. 
Sequence Diagram 




Figure 19: Login sequence 



3. Logout 

This use case allows the editor to log out from the Hermes system. 

Basic Flow of Events 

1. The editor selects the Logout action 

2. The system sends a logout request to the Hermes system 

Preconditions 

• The editor has been logged in. 
Post conditions 

• The editor has been logged out; Hermes actions can no longer be 
performed. 
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Sequence Diagram 



Hermes Connector 



Hermes SOAP 



HermesLogoutRequest 



S 



HermesLogoutRequestResponse 



Figure 20: Logout sequence 



4. Save Object 

This use stores an InCopy object in the Hermes system. 

Basic Flow of Events 

1. The editor selects the Save object action. 

2. The system sends a request to the Hermes system. 

Alternative Flows 

New document 

If an object has not been saved before a form will be presented to the 
user, comparable to the New page form, pp 

Preconditions 

• Editor has been logged in. 

• An InCopy object has been opened. 

Post conditions 

• A new version of the InCopy object has been stored in the Hermes 
system. 



Sequence Diagram 




Figure 21: Seve object sequence 
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Figure 22: Save object sequence - alternative 

5. Open Object 

This use case opens an InCopy object. 

Basic Flow of Events 

1. The editor chooses the Open object action 

2. The system sends a Get request to the Hermes system. 

3. The system opens the object. 

Alternative Flows 

Locked object 

If the object is locked, it will be opened read only. 

Preconditions 

4. The editor has been logged in. 

5. An object has been selected. 

Postconditions 

• The object has been opened. 

• The object is locked on Hermes 
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Sequence Diagram 



Hermes Connector 



Hermes SPAP 



HermesGetObject 



Open object 



Figure 23: Open object sequence 



6. Close Object 

This use case changes the status of the object. r= 



Basic Flow of Events 

1. The editor selects the Close object action. 

2. The system sends a unlock request to the Hermes system. 

Alternative Flows 

Opened object 

If the object is modified, the editor is asked if the object should be saved 
before closing . 



Preconditions 

• The page designer has been logged in. 

• An object has been opened. 

Post conditions 

• The object has been closed. 

• The object has been unlocked in the Hermes system. 
Sequence Diagram 



Hermes Connector 




Hermes SOAP 








i 
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HermesUntockObject j 

















Figure 24: Ctose object sequence 
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7. Release Object 

This use case changes the status of the object. 
Basic Flow of Events 

3. The editor selects the Release object action. 

4. The system shows the Release object form. 

5. The editor enters the needed information. 

6. The system sends a request to the Hermes system. 

Alternative Flows 

Opened object 

If the object is currently opened by the editor, the object will be saved and 
closed, before it's released. 

Locked object 

Objects locked by entities other than the editor, cannot be released by the 
editor. 

Preconditions 

• The page designer has been logged in. 

• An object has been selected. 

Post conditions 

• The object's status has been changed 

• If opened by the editor, the document has been saved and closed. 
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Sequence Diagram 
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Figure 25: Release object sequence 

8. Delete Object 

This use case removes a Hermes object from the system. 

Basic Flow of Events 

1. The editor selects an object 

2. The editor chooses the Delete object action 

3. JJe system sends a delete request to the Hermes system. 

Alternative Flows 

Locked object 

When the object is locked, the object cannot be deleted. 



Preconditions 
• The editor has been logged in. [= 



Post conditions 

• The Hermes object has been deleted. 
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Sequence Diagram 



Hermes Connfictar 



Hermes SOAP 



Hermes DeteteObject 



Figure 26: Delete object sequence 
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1 Introduction 

1.1 Purpose 

The purpose of this document is the definition of the architecture and design of 
the SOAP Application Server that empowers the current Hermes solution and 
minimizes the effort needed for creating a new server side component. 

1 .2 Scope 

Scope of this document is the SOAP Integration Platform project, whose design 
specification is referenced later 

1.3 Definitions, Acronyms and 
Abbreviations 



ACRONYM 


DEFINITION 


REFERENCE 


NCM-HERMES 


NEWS CONTENT / 
MANAGER 




NGM- 

WIRECENTER 


NEWS GATHERING 
MANAGER 




SAS 


SOAP APPLICATION 
SERVER 




LS 


LOGBVSERVER 


Security and license manager 
for Hermes 


SOAP 


Simple Object Access 
Protocol 


http://w3.ore/SOAP 


XML 


Extensible Markup 
Language 


htto://w3.ors 


HTTP 


Hyper Text Transmission 


http://w3.orp/Protocols 




Protocol 




HTTP-S 


Hyper Text Transmission 
Protocol - with data 
encryption 


http://w3 .ore/Protocols 


SOAP 


Simple Object Access 


http://www.w3.ore/TR/SOAP 




Protocol 




Hermes Agent 


An HTTP bridge to the 
Hermes system 






Unisys 
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CMMI 


Capability Maturity Model 
Integrated 


http://www.sei.cmu.edu/cmmi/ 


DOM 


Document Object Model 


Standard for XML navigation, 
parsing and construction 
htto://w3.ore/XML 



2 Referenced documents 

Below is the table of standards referenced in this document 
Table 1 Table of referenced standards 



Description 


Reference 


SOAP 


htto ://w3 . ore/soap 


Specification 


version 1.3 




OpenSSL 


htto://www.openssLorg 


specification and 


downloads 




Multipart 


httD://ietf.ore/rfc.html RFC 2387 


messages 




IANA official 


htto://www.iana.org 


registered mime 


types 




The Unified 


http://www.rational.com 


Modelling 


Language j 




specification 




version 2.0 j 





Additionally, readers should refer to the following documents: 
[1] SOAP Integration Platform design specification. 

[2] SOAP Event and mailing schema file, provider later during the 
development 
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3 Constraints 

There are some key requirement and system constraints that have a significant 
bearing on the architecture. They are: ^ 

• The SOAP application server lies on top of NCM and runs on Windows and 
Solans operating systems. The operating system version will be defined bv 
the Unisys internal certification plan. 

• ^ SA f. is . re 1 leasedunde '- a specific license and is an optional component 
of the editorial system. 

The SAS is the direct interface between the external applications and the SOAP 
integration platform. Key responsibilities can be identified into: 

• Session Management. The SAS manages the session related to each 
connected user in order to deliver requests to the integration platform for 
the real processing. No activity can be performed by client applications 
without having a valid session instantiated on the SAS. 

• Hermes Configuration Management. NCM stores important information in 
the Hermes.cfg file, such as workflow statuses and transitions, publication 

,.7 can ^ ver y hu 8 e a* 1 * delivering it directly to the client via 
HTTP could be expensive in terms of performances. Furthermore, reading 
the hermes.cfg file requires a set of proprietary API to be released and this 
creates a strong dependency to Hermes. Thus, an important responsibility 
ot the SAS is the server side management of the hermes.cfg file. 

• Event Management. The SOAP Integration Platform enables third party 
applications to be part of the entire production system, which is 
comprehensive of the event dispatching from NCM system. Events can 
notify client applications about changes in the database, such as page layout 
modifications which is a key feature in a collaborative environment. 

• Secure Connections. The entire HTTP handling is provided with SAS and a 
icey requirement is the implementation of secure connections to protect 
sensible data travelling across the network. 

This key feature will be part of the SAS core module instead of making them 
separate SOAP services. This assumption is due to the fact that such activities 
are critical and cannot be removed from the system. SOAP services will 
perform activities more related with the editorial interaction and they can be 
unplugged from the SOAP layer without affecting the rest of the layer, while 
removing services such as "login" does not make sense. 
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4 Logical view 



The following picture is a high level view of a possible scenario 



PC 




HTTP / HTTP-S Protocol 




HTTP / HTTP-S Protocol 




MAC 



SOAP Application Server 



SOAP Core 



Figure 1 Overall system architecture 

The new module will reuse the Hermes networking framework in order to 
reduce the effort and maximize the results. In fact, although different good 
libraries and framework are available around the world, the current Hermes 
Networking framework has more than ten years of test on site and, thanks to 
the continuous stabilization of the framework, it lets Hermes manage huge 
amount of data with very high-speed performances. 



4.1 Subsystem design 

The SAS must be a concurrent multithread server that uses a thread per 
connection model for processing incoming requests. The overhead required to 
spawn new threads is minimal, considering the performance gained for 
processing requests. In fact, different incoming requests and responses could 
have heavy load attachments that may require to be processed or sent back to 
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the client that could compromise the performances of other incoming/outgoing 
data. 

Performances should be optimized using a thread pool. In fact, by using a 
thread pool, the overhead for spawning a new thread at each connection can be 
minimized or, better, concentrated at the application start-up, thus reducing 
latency at run-time. By using the eager spawning technique, a thread pool can 
be resized dynamically and provide a dynamical expansion/contraction of the 
pool itself, by taking into account the load that the server is managing. For 
example, if a thread pool is totally in use, the expansion could create a new set 
of N threads in the pool to fulfill the incoming requests. 



5 SAS and SOAP core 

The SAS works tightly close to the SOAP core implementation. Each request 
coming from the client application must be verified against the HTTP standard 
to check its compliancy. After that, the HTTP header is filtered by checking 
that the SOAP Action element really contains a valid value, otherwise the SAS 
does not allow the connection and responds with an HTTP error. 
Once the request has been verified for a valid HTTP, the body of the HTTP 
message is sent to the SOAP core, which process the XML SOAP request 
Details of the operations are available in [1]. 

The effort needed to build the SAS can be reduced at minimum by taking 
appropriate decision that leverages the current Hermes server side framework. 
Hermes has a very powerful networking framework that has more than ten 
years of field testing. Such a framework can be extended to support HTTP / 
HTTP-S with a small amount of coding. 

5.1 SOAP Actions 



SAS must support three different types of SOAP Action (see [1]). Two of them 
will be used for login/logout operations since the SAS directly is taking care of 
this critical services, while the third one will be used for all the other SOAP 
request that provides access to Hermes. 

For any other operation, the server will route all the SOAP requests to the 
SOAP core after verifying that the value of SOAP Action is equal to 
HermesSOAP. 

This apparent simplicity is the base for the evolution of the SAS and the entire 
SOAP Integration Platform. As an improvement, the SOAPAction could 
contain the URL of a different SOAPServer. The first server could act as a 
"macro-dispatcher" to redirect requests that can be processed somewhere else. 
This strategy enables a true distributed architecture with a high level of 
scalability and capacity. 
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A possible implementation of these concepts could be the extension of the 
SOAP platform to other applications such as NGM that runs on a different 
server. In this case, the SOAP Action element will contain the address of the 
NGM endpoint and every request will be automatically redirected to the NGM 
SOAP server for the processing. 
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6 Event dispatching, mail and alerts 

The S AS must be able to deliver alerts, events and Hermes mail to the "client" 
applications. This can be easily obtained by leveraging the current Hermes 
Event Manager subsystem with some particular considerations. While the event 
management in the Hermes environment is "easy" because of the proprietary 
protocol and multicast availability, on the HTTP protocol this task can be 
trivial. 

By definition, the HTTP protocol is stateless and the client application is not 
always connected to the server as in the Hermes LAN environment. For 
enabling the event, alert and mail message the concept of role-exchange can be 
applied. The client application will register to the SAS sending the URL and a 
port on which it wants to be recalled. Once an event is generated in the Hermes 
environment, the SAS will become the client and the registered client 
application will become the server. In this way, the SAS will perform a POST 
operation over HTTP on the URL supplied by the registered client. 

6.1 Special Considerations 

This mechanism must be implemented as close as possible to a "fire and 
forget" system. In fact, the SAS must not be blocked for waiting responses 
from the client application. The HTTP POST must be delivered by the SAS and 
it lets the server do other jobs while the client application is processing the 
event. If the server will wait for a response coming from the server and the 
client application crashes for any reason, the SAS will have a socket connection 
unavailable until a timeout expires, causing potential deadlock in the system 
and unpredictable side effects. 



7 Deployment view 

The installation of the SAS will be made by using the wizard normally used to 
install other server applications. Registry requirements will be explained when 
the implementation is consolidated. 
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1 Introduction 

This document is the detailed design specification of the SOAP Integration 
Platform system. It refers to the design phase of the project 70-IPAI- 
SoftwareDevelopmentPlan. 

2 References 

The following table shows the references to the standards used during the 
design. 



Table 1 Referenced standards 



| Description 


Reference 


SOAP 

Specification 
version 1.3 


htto://w3.orfi/soap ~~ 


OpenSSL 
specification 


http://www.ODenssl.orp 


Multipart 
messages 


http://w3.org 


IANA official 
registered 
mime types 


htto://www.iana.org 


OPI 1.3 
specification 


http://partners.adobe.com/asn/developer/pdfs/tn/OPM3.pdf 


OPI 2.0 
Specification 


http://partners.adobe.eom/asn/developer/pdfs/tn/5660.OPL2.0.pdf 


Adobe XMP 

technology 

specification 


http://partners.adobe.com/ 


The Unified 
Modeling 
Language 
specification 
version 2.0 


http://www.ratlonal.com 
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Reader should also refer to the following Unisys documents 
Table 2 Unisys referenced documents 



Description 


Reference 


HE70-DS-SAS 


SOAP Application Server Design 
Specification 


HE70-FS-AQTPA 


Advanced Query in Third Party 
Applications via SOAP Integration Platform 


iPlatModel. jndl (temporary 
name) 


SOAP Integration Platform Rose Model 


HE70-MS-AINCM.doc 


Vision document - Solution Management 
requirement for third party application 


HE70-DS-AIES.doc 


Adobe Integration with ^Editorial Solutions 
Design Specification 



3 Definitions, acronyms and 
abbreviations 



Table 3 Definition, acronyms and their references 



ACRONYM 


DEFINITION 


REFERENCE 


SOAP 


Simple Object Access 
Protocol 


htto://w3.ore/SOAP 


XML 


Extensible Markup 
Language 


hto://w3.ors/XML 


HTTP 


Hyper Text Transmission 
Protocol 


httr>://w3 .ore/Protocols 


HTTP-S 


Hyper Text Transmission 
Protocol - with data 
encryption 


htto://w3 .ore/Protocols 


IFRA 


largest international 
exhibition dedicated to 
newspaper and media 
technology 


htto://www.ifra.com 


Hermes Agent 


An HTTP bridge to the 
Hermes system 




CMMI 


Capability Maturity Model 
Integrated 


http://www.sei.cmu.edu/cmmi/ 


DOM 


Document Object Model 


Standard for XML navigation, 
parsing and construction 
http://w3 .ore/XML 
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4 System Overview 

The SOAP Integration platform is a framework built on top of the existing 
Hermes editorial system. The purpose of this software layer is to make a 
large set of Hemes API available to system integrators, in order to produce 
content with different software that can take advantage of the Hermes 
editorial production system. 

The design of the system relies on standard protocol for the communication 
and on SOAP as the lightweight protocol to enable interaction with the 
outside world. 

Particular interest must be reserved to extensibility and modularity, in order 
to minimize the impacts on other components when adding functionalities. 
The system will be separated into two logical components: 

• Core Service, responsible for managing the run-time mapping from 
SOAP calls to WEB services and vice versa 

• WEB Services, responsible of wrapping Hermes calls in a transparent 
way to the Core Service layer. Each request dispatched from the Core 
Service is rolled out by each specific WEB service. 

The entire architecture includes a new Hermes module responsible of 
managing HTTP connections/request. 

5 Architecturally Significant Design 
Packages 

An overall component diagram of the system is shown below: 
Figure 1 SOAP Integration Platform overview 









SOAP Core 
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Hermes SOAP 
Services 
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6 Design Consideration 

Most of the code used to write Hermes is C/C-H- code and, although the 
core has a well-defined set of APIs, it does not allow direct interaction with 
applications different from the clients that are part of the system. 
Furthermore, Hermes uses a proprietary communication protocol that is 
difficult to "externalize", because it requires that a set of specific libraries 
on server and on the client must be available. 

This requires that the client must be equipped with a software package that 
prevents it from being completely independent from the implementation of 
the server side. 

The design of this framework will focus primarily on extensibility and 
modularity: " 

• Extensibility: by separating the core service module from the actual 
implementation of wrappers around Hermes API, the extensibility is 
achieved, since is implicit the ability of adding new services. 

• Modularity: in order to achieve the maximum level of extensibility of 
the framework, the core service layer must be separated from the actual 
Hermes wrapper implementation and specific services will be provided 
by small components plugged to the framework. 

The design of a SOAP Platform that lies on top of Hermes is possible 
without a great effort because of the similarity of the network protocol used 
by Hermes with the HTTP concept. In fact, although they are different in 
constitution, both rely on the request response strategy to implement 
communication between client and servo-. 



6.1 XML Parser 

XML is managed through the use of the Xerces library, which offers a C++ 
implementation of the DOM conform to the W3C specification. 
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7 Architectural Goals and 
Dependencies 

The SOAP Integration Platform will be designed to exploit the existing 
Hermes implementation, allowing the Hermes system to interface with any 
other external application. The WEB services will implement services by 
calling and arranging the existing Hermes APIs. Specific assumption and 
dependencies are: 

• There will be no new development inside Hermes to adjust gaps 
between SOAP and the core. Instead, the design assumes as a fixed 
point the existence of Hermes. 

• A new module will be implemented as the endpoint server for two 
reasons: 

> The existing hermesagent cannot be overloaded since it is used 
for the HermesWeb product and no modification to the 
performances is possible. 

> The Integration Platform is a product that Unisys will deliver 
under license and not as an add-on to an existing licensed 
product 

• No direct database operation will be performed. Each access to the 
Hermes storage will rely on the existing Hermes APIs, in order to 
leverage the current capabilities. 
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8 Constraint 

As mentioned before, Hermes is a proprietary system built with C/C++ 
language. Java should be the natural way of building a SOAP extensible 
layer but the gap between the two languages is difficult to be managed and, 
when managed, it relies on a difficult to understand mechanism that cannot 
be easily reproduced. 

r 

8.1 Hardware constraint and 
requirements 

The SOAP integration platform will be available for both Intel and SPARC 
processor. 

8.2 Software constraint and 
requirements 

For the software environment: 

- Windows 2000 Advanced Server 

- SUN Solaris 5.8, 32 bit version 

Both platforms will be available according to the Unisys certified standards. 
The implementation of the code must take into consideration of the 
architectural differences among platforms. 



8.3 Performances 

The design of the framework will take into high consideration the 
performance issue and no degradation or limitation to the existing Hermes 
system will be caused by the framework itself. 
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8.4 Network Communication 

Network communication between the Integration Platform and the various 
actors will rely on standard HTTP / HTTPS transport over TCP/IP protocol 
The communication mechanism used inside Hermes is request-response 
based. Client applications post a request to the server and wait for the 
response from the server which does all the processing requirement The 
same concept is applied to the HTTP, with the main difference in me 
purpose" of the protocol. The Hermes proprietary is tailored for the 
protmol appUcati ° n needs ' While HTTP 18 a multi-purpose generic 

This means that performances are quite different, since the HTTP needs a 
lot of extra meta-infonnation to describe the data it is carrying over the 
network. Due to mis verbosity, a particular attention is paid in the 
optimization of long responses from the SOAP server. 
The SOAP integration platform provides communications in both plain 
HTTP and over Secure Socket Layer by using the OpenSSL library. The 
secure framework implementation is, however, responsibility of the SOAP 
application server, which design is detailed in document HE70-DS-SAS. 

8.5 Verification and validation 

The entire platform will be tested with specific procedures to ensure that: 

• Multiple concurrent SOAP messages can be delivered to the services 

• Buffer overflow protection is correctly implemented 

• Invalid XML packets are coirectly handled without problems to the 
SOAP core 

• Malformed HTTP requests are handled correctly without problems to 
the SOAP core 

Each developed service will be placed under regression test to ensure that 
no alterations to the SOAP core service layer have been made. 
The alpha tests will be made by using scripts to send XML calls to the 
framework. The scripts will be refined on use and delivered to the testing 
group as an add-on to help integrity test. 
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9 System Logical View 

In order to depict a logical view for the system, a typical usage scenario is 
shown below. 



10 Subsystem design. 
10.1 SOAP Application Server. 



The SOAP application server is described in document HE70-DS-S AS 



10.2 SOAP Service layer 

The SOAP Service Framework is responsible of the management of the 
SOAP requests received by the SAS. The SAS checks the HTTP header for 
validity of session id and SOAPAction values. If these values cannot be 
verified, the request is not handled and an error is returned to the caller in 
the form of a SOAP fault. 

If the HTTP header is valid, the SAS calls the SOAPService Registry and 
passes the SOAP request. The SOAP service registry looks for the service 
handler (WEB Service) that implements the method requested via SOAP 
and, if a service is found, it dispatches the SOAP call to the specific WEB 
service for being processed. The SOAP core will offer a set of methods to 
the WEB services, thus allowing to: 

• Get parameters from the SOAP call 

• Get the value of the parameters appropriately converted to C/C-H- type 

• Create the SOAP response to the call and abstract any specific XML 
construction and handling 



10.2.1 Service Registry 

The service registry lies in the SOAP core and is responsible of maintaining 
the list of service and the mapping between SOAP methods and services 
that implement them. In order to keep a high level of extensibility, the 
services are mapped to specific calls via an XML file (deployment file) that 
is read during the server start up. 

Doing so, enabling or disabling specific services will simply imply 
removing the mapping inside the deployment descriptor. 
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Furthermore, a particular protection level is placed into the service registry 
to allow continuing to offer services also if one or more services are deleted 
from the file system. The service registry is implemented as a singleton 
object using the Smgleton pattern, in oider to give the caller a single point 
of access to the WEB Service instantiation point. 

The service registry singleton should be implemented with a double- 
checked locking pattern (SchmidU 2001 145) . Although the service core 
itself does not dispatch services into different threads because it relies on 
the mulu&read S AS engine, this rule could become invalid for performance 
reasons. By definition, the singleton exists in a single instance The 
constructor of this type of object, however, cannot have a locking 
mechanism because of the following race condition: 



Figure 2- Multithread unsafe singleton instantiation 
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When the thread A is in the LOCK condition is about to create the static 
pointer. When the thread B comes into, no instance is available and 
proceeds to its creation. To prevent this, the double-checked locking pattern 
[2] tests for the instance of the object and, if it does not exist, the object is 
locked. After the lock is acquired, the thread tests again the instance to see 
if in the meantime another thread created it. The maximum level of safety is 
achieved because the second thread waits until the mutex is available and, 
when this condition is true, the thread finds the instance already created and 
returns the pointer to the instance itself. 



« Concurrent access to the singleton - Drawing Placeholder» 



Figure 3 Thread safe singleton instantiation 



After the Service registry has determined the method that is being called by 
parsing the SOAP request, it returns a pointer to the WEB service entry 
point in order to dispatch the work. 

By using the double-checked locking pattern, the atomicity of the change to 
a singleton object is guaranteed even in multi CPU environment. In a single 
CPU environment, in fact, threads are "interleaved" and concurrency occurs 
less frequently than in multithreaded applications running on different 
CPUs. 

The service registry is as an object fectory and should be implemented as in 
[4] to decrease the interdependency between implementation of the core 
and implementation of the services and to speed up the SOAP dispatching. 



1 0.2.2 Service entry point 

In order to decrease the dependency between the core and the modules, the 
SOAP integration platform uses a deployment descriptor to map the service 
implementation to a service entry point. Whenever a request comes into, the 
service registry looks up the SOAP method into the XML payload and 
searches for a suitable implementation. If an implementation is found, its 
entry point is called to instantiate the actual service implementation. 

C++ language does not allow a class to be created using its name as 
parameter, for example, to the constructor. A code such as 



const char *className = n Specif icClass" ; 
BasePointer *inatanceOfTheClass = new className; 
Is not valid. 
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The solution of such a problem, which enables the ability of mapping 
service to method in an external file, is to use the inheritance to make all 
the service implementation specialization of a base class. Each 
implementation method inside the WEB service, has a C entry point whose 
name is actually mapped to the service via the deployment. The service 
registry reads this entry point from the deployment descriptor, loads the 
WEB service dynamically and gets the address of the creator function 
(entry point). Once this has been done, the service registry calls the entry 
point of the WEB service that does nothing but creating a new "class" and 
returning a pointer to it 

Implementation class 
class SOAPImplementation : public SOAPServiceHandler 
The entry point will be 

SOAPServiceHandler *EntryPointFunction ( ) 

{ 

return new SOAPImplementation; 

} 

This is the only way to bypass the previously mentioned C++ limitation. By 
using this technique, each SOAP call can be added to the entire framework 
without recompilation of the layer. 

The collaboration diagram for the service lookup and dispatching is 
reported in Figure 4 

Figure 4 Service instantiation and dispatching 
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The service registry maintains a mapping between the service name 
exported and the module that implements the function. This mapping is 
loaded at the service registry instantiation by reading the deployment 
descriptor from the file system. The deployment descriptor is an XML file 
that maps the name of the entry point inside the service and the dynamic 
library with the implementation. Since this mapping does not change during 
the service registry run time, it should be optimized for fast searches rather 
than for fast insertion. A suggestion for obtaining fast searches is to use the 
standard library vector instead of a map. As discussed in [3] using a sorted 
vector of elements is significantly faster than using a map of keyed value 
since the map is implemented as a RB-tree with overhead that is optimized 
for fast insertion. 

Once the service has been found and instantiated, the SOAP core finishes to 
parse the XML and loads the parameter map. 



10.2.3 Parameters Map 

The SOAP core manages two types of parameters: 

Simple parameters 

Complex parameters (structure) 

Simple parameters are used to map directly name-value pair, while complex 
parameters can contain simple parameters. This allows the SOAP 
framework to manage a large variety of parameters combination, m fact, by 
usmg a Composite Citations 

[1] pattern, it is possible to manage parameter that can be composed of a 
structure and each element of the structure is composed by other structures 
To create the correct parameter object, which . depends on the XML 
structure of the SOAP request, a class factory Citations 

[1] is used to delegate the construction of the appropriate object. The 
collaboration among object is represented by the following diagram: 
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Figure 5 Collaboration diagram for parameter creation 
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The parameter map should be implemented for fast retrieval rather than for 
fast insertion, thus the suggestion becomes the same as per the service 
mapping discussed in chapter 10.2.1 



10.2.4 Attachments parameters 

The integration platform allows creation of content with third party 
applications and such a content is "converted" to Hermes objects and pages. 
SOAP incoming messages must have the ability to attach files. To allow the 
mixed XML and binary content in a SOAP message, a multipart - mime 
message is used. The SOAP core is responsible for the parsing of the 
multipart message and the storage of the raw bytes of the attachments. 
Details of messages with attachments are provided in the HE70-DS-AJES 
document, where the interface between the system and client applications is 
fully described. 
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10.3 Hermes Web Services 



Hermes Web Services are components that are plugged into the SOAP 
Integration Platform to perform the real request processing. These modules 
are implemented as dynamic link libraries that are loaded on demand and 
stay active during all the run time. 

Hermes Web Services have the responsibility to wrap Hermes legacy code 
into object-oriented components that are instantiated by the platform. The 
effect on the Hermes code is null and the implementation can leverage the 
existing API, thus minimizing the effort to make Hermes an open system. 
The services should be divided into "categories** depending on the task they 
run. A special category is that including services responsible of critical 
task, where this tasks cannot be unplugged from the platform since they are 
vital for the existence of the platform. In this category, the following 
services will be placed: 

Login service 

Logout service 

Session management service 



These types of services cannot be mapped into the deployment descriptor, 

thus they cannot be unplugged from the platform, 

Hermes specific services are divided into the following categories: 



Service category 


Hermes specific task 


Objects 


Hermes object management, such as creation, deletion, 
retrieval of objects. 


Pages 


Hermes page management, such as creation, deletion, 
retrieval of pages, link/unlink of objects to/from pages • I 


Edition 


Edition management, such as edition listing, zone 
management 


Workflow 


Object and page status management 


Users 


User management, such as user data retrieval, permission 
checking 


Level 


Level management, such as level browsing 



10.3.1 Module caching 

The SOAP core manages the various WEB services by keeping a table of 
method/service implementation. Each time a method is run, the table is 
updated by incrementing the usage count for the module and decrementing 
each module that has not been hit. When the counter for a module is equal 
to 0 (zero), the module is discarded thus gaining memory and, 
consequently, performances. 
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10.4 WSDL 
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1 Scope 



1.1 System Overview 

The purpose of this project is the integration of third parties applications with 
the Hermes editorial system. Third party applications store their content in 
Hermes by placing the native format file onto the file system. Hermes clients 
need to show the content of the pages and objects generated by such 
applications. 

External logical pages will allow the end user to use external software such as 

Adobe InDesign to produce pages that will be managed by Hermes. 

The intent is to define a protocol that allows current implementations to handle 

such pages in a transparent way, as well as the standard Hermes pages. 

To achieve this goal, the Newsroom content must be modified to store the path 

to the EPS preview of the page. 



1 .2 Document Overview 

This document describes how Hermes will manage the logical pages created 
with third party applications using the SOAP integration platform. 

2 Referenced documents 
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3 System design decisions 

In designing this feature, we will consider the current system architecture and 
empower it, in order to keep the code changes as slight as possible and leverage 
the current implementation of NewsRoom, UPS-Explorer and all the 
applications that handle logical pages and objects. 

3.1 High level system behavior 

The logical pages created with external applications will be stored as files in 
the Hermes file system in order to allow the native application to reopen it. 
External applications will produce a preview of the page, either in EPS or in 
JPEG format, that will be used by Hermes client to show the preview of the 
page and, generally, to overcome the impossibility to read native format files. 
Currently, there is no support of previews in PDF but we'll keep the focus on it . 
since it could be a major improvement in order to achieve the complete 
PDF/X1 A - PDF/X3 workflow adopted by major magazine producers. 
Hermes needs to keep track of the page in the database in order to: 

• Enable the workflow for the asset 

• Enable the imposition software to directly paginate it 

• Enable the tracking of objects linked to external pages, allowing the current 
UPS-Explorer to perform queries on object linked to a specific page and 
vice versa 



3.1 .1 Description of pages handling 

External application creates logical pages that will be recognized as normal 
Hermes logical pages. This will lead to slight modifications of the Hermes 
clients in order to allow the Hermes applications to handle these pages. 
To show the external pages, a new set of markers will be placed into the 
content field to identify the data relevant to the external page. In this block of 
data, the same information used to archive images (called DBBUFFER) will be 
placed, along with the path to the EPS for the preview of the page. This allows 
Newsroom to transparently handle this content, even if the real page has been 
designed using an external application. 

When Newsroom reads the content and encounters these markers, it will read 
the path to the EPS, create a dummy layout whose size will be exactly as the 
size of the EPS and perform a "link on the fly" to the EPS, 
By using the distributed grid functionality of the SOAP server, an external 
client can produce pages having the same size as the grid, thus keeping all the 
dimensions consistent This means that the choice of a particular grid will 
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produce an EPS exactly sized as the grid and, since grids are taken directly 
from the server, all the dimensions will be consistent 

All the modifications to the external page content will be possible only using 
the ongmatmg application, while the preview attached to the dummy layout 
tvlt^ bKkgmund of the Newsroom page and dxan^wK 
mhibited.The Newsroom page will have a layered structure, so tZ it is 
possible to add Newsroom layouts to the external page, since the content will 
be the same. All the new elements added to the page are standard Newsroom 
elements that will be visible only in NewsRoom. If the externaiTage S 
reopened with the originating application, the external software will matiage 
only the part relevant to the application itself. Since the external page is treated 
as a whole, Newsroom elements cannot be merged with external page elements 
because NewsRoom will not known the position and geometry of the elements 
inside fee external page. Tins is a limit in the multiple application page 
composition. Clipping between elements will be possible manually. This means 
that, tor example, if a Newsroom layout is placed in a certain position with 

m eXtemal page md ms ob J ect cha *g<* its position 

inside the page, the adjustment of the NewsRoom layout must be corrected 
To minimize the side effects on other Hermes client applications, all the storage 
and management must follow the currently in place rules. An external logical 
nornUpage 6 * ^ ^ t0 be vieWed b y NewsRoomlis a 

In order to identify an external page to prevent modifications, for example in 
ayoute, the external logical page is linked to an external layout The external 
layout is skipped m all the modification functions in Newsroom, thus resulting 
m a protected layout. However, the layout will be fully compliant with the rest 
of the layout types, except that it's marked as external. This homogeneity 
allows the tracking of the objects linked to a page, even if the object is not Z 
internal Hermes object and the page is not an internal Hermes page. Whenever 
an external application links an external object to the page (for example 
InDesign page links an InCopy object), a notification via the Integration 
Platform is made to keep track of the operation. 

Once the notification is received by the Integration Platform, a new "Hermes" 
link between fee page and the object is created inside the database in the same 
way it s recorded when an object is linked to a page in Newsroom 

™L£ fTTf* WhGn r ° bjCCt is unlinked from a page, a notification is 
made to the Integration Platform which will remove the association from the 
database. By using the common link/unlink protocol used by Hermes and 
treating pages and layouts for external application in the same manner Hermes 
does, it will be possible to query a page for all the linked object also for 
external pages. 

Since unlinking objects from pages in most cases results in the removal of the 
object from the page, the unlink operation will be available only in the 
originating application. 

In other words, the unlink of a photo or an InCopy text attached to and 
InDesign page is possible only from InDesign, considering also that the 
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InDesign file must be updated to remove the internal link and the knowledge of 
this process is available only on the client application. 

However, if a server side InDesign manipulation tool will be released by Adobe 
in the future, the implementation of the link and unlink between objects and 
pages will require the specific "tool-side" implementation, without changing 
the mechanism currently in place on Hermes to handle external asset link. 



3.2 InCopy specific changes in 
NewsRoom 

Currently, InCopy is not able to generate a preview of the text. Furthermore, if 
an InCopy object is linked to an InDesign page, InDesign holds the text 
representation of the object. To let Hermes clients to "see" a preview of an 
InCopy object, a dummy preview is used. 

Since the object linked to the external page appears as a link for NewsRoom, a 
specific adjustment must be made in order to let NewsRoom skip the 
visualization and printing of the dummy preview. The real content of the 
hidden object is already on the InDesign page. 

If the InCopy object is linked to a NewsRoom native page, the content of the 
object is converted into NewsRoom textual object and the process can proceed 
as a normal object linking in NewsRoom and the dummy preview problem is 
automatically solved. 

For each other type 1 of external object, there is no special requirement since 
they will be treated by NewsRoom as image objects. 
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3.3 Limitations 

All existing Newsroom functionalities will be maintained. 
It will not be possible to create layout that automatically clip the external page 
layouts. Newsroom elements added to the page will overlap* the EPS 
representing the preview of the external page. 

Information about added elements will be stored into the content field but not 
in the external pages markers, which will be skipped by Newsroom each time 
an operation is performed. 

Complex pages with shapes of both applications (Newsroom and external 
application) will be created by overlapping the elements and no constraint 
check will be done by Newsroom. The external page will be a read only page. 
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4 Performance 

The management of layered pages will not degrade the performances of 
NewsRoom. In fact, by using the external layout strategy, all the operations 
will be transparently handled by NewsRoom, without requiring code overhead 
to handle special cases for external pages. 



4.1 Speed 

No degradation in speed due to the implementation of the system. 

4.2 Reliability, availability and 
maintainability 

No degradation in reliability, availability and maintainability due to the 
implementation of the system. 



4.3 Capacity 

No degradation in capacity due to the implementation of the system. 
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1 Introduction 

The Hermes Integration Platform is a new development that enables third party 
applications to be part of the Hermes editorial system by using the standard protocol 
over the HTTP transport protocol. 

The following document shows a general picture of the currently implemented 
software prototype that has been shown at the recent IFRA Expo and a proposed 
implementation for the final product. 



2 Overview 

The current implementation of the SOAP Integration Framework relies on the 
HermesAgent service which handles the incoming HTTP requests. 

Each request is verified against the presence of a particular HTTP header value 
(SOAP Action) that, if the header value is set, copies the content of the request to the 
SOAP core library. 

The SOAP core library is responsible for parsing the XML request, determining which 
method has been called via SOAP and dispatching the method call to the appropriate 
WEB service. The WEB services are loaded dynamically on demand and are 
implemented as a separated piece of running units. 

HermesAgent is a module acting as a bridge between the WEB world and the Hermes 
system by taking care, for example, of dispatching sessions and managing the Hermes 
configuration in a environment that is slightly different from the Hermes usual one. 
The HermesAgent has not been created as a replacement of a WEB server but to be the 
easiest and quick deliverable way to enable Henries to the WEB. Thus, the overall 
architecture is comprehensive of a standard Web Server (IIS, Apache), which handles the 
connections from the WEB and calls a "plugin" that runs on the HermesAgent via a CGI 
application. 

The overall picture is shown below 



■■■■ 


CGI 


I HermesAgent 
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Due to a serious issue arisen with IIS and the Hermes System together, the HennesAgent 
has been extended for the IFRA Expo prototype to directly support the HTTP protocol 
without using a CGI. 

The extension has been made not to replace a complete commercial Web Server but to 
overcome the cross-platform issues between different Web Server implementations. In 
fact, CGI would not be used as a pass through modules because the performance issues 
and the server-based modules are based on proprietary and different technologies such as 
Microsoft ISAPL 

Thus, the solution used for the prototype has been modified as shown below: 



IIS / t 


\RAGHE 

CGI 


■n 


1 HerrnesAgent 


I H I I P ext. 



Hermes Core i SOAP 



The current working solution is not a deliverable product since it has been built for the 
prototype purpose only, therefore without all the care required by a real product. 
However, extending the HerrnesAgent to fulfill the requirement of the SOAP Integration 
Platform can be dangerous since it is currently used in the already released HermesWeb, 
which uses for the internal networking communication the Unisys proprietary protocol. 
Adding a new communication protocol could lead to a mixed, hybrid solution which 
could slow down the overall performances of both usage scenarios of the Hermes Agent. 
Furthermore, one of the key requirements of the Integration Platform is the secure 
connection implementation (HTTPS) and implementing it in the current HerrnesAgent 
can be a hard task because the compatibility with the currently production software must 
be maintained. 

After the IFRA expo, the R&D team has analyzed the HerrnesAgent prototype 
implementation and found that most of the code could be moved in a small framework 
which supports HTTP/HTTPS directly, without interacting with a web server. 
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3 Technical Requirement 

With the decision to release the Integration Platform with Hermes 7.0 (internal name), 
there will be the opportunity to leverage the existing HTTP framework used in the 
prototype and make a new service that will be called SOAP Server. In this way, the 
Integration Platform can become a complete and separated licensed product. 
The requirements that the new service must have are listed here below. 
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SOAP Application 
Server 
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HTTP and HTTPS support 

The new service must support HTTP connection as well as HTTP with SSL. 
Performances 

The new service must be able to support concurrent connections 
Hermes core reuse 

The SOAP service will rely on the existing Hermes Server Framework to take 
advantage of the proven stability of the APIs. 

4 Advantages 

Having a separate complete independent SOAP Integration platform is the preferred 
solution for the following reasons: > 

1. Software 

a. A different code limits the impact of the existing production one. 

b. The performances can be dramatically improved because it is not necessary to 
mediate between what has been done for the WEB and what is being doing for 
the SOAP Integration Platform anymore. Typically, the amount of data passed 
through the Hermes Web via the HermesAgent is not very high. Conversely, 
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the SOAP Integration Platform manages native files created by different 
applications and EPS that can be very huge. Using the same Web interface for 
both Hermes Web and SOAP Platform can result in a serious degradation of 
performance and it is expected that, when two Adobe clients will send two 
EPS of tenth of MB in size, no other can work friendly with Hermes Web. 
c. No more needs to maintain a timeout on the session (which is required for the 
Web). It is possible to implement the same behavior as in Hermes and this is a 
great improvement. Suppose that a huge IhDesign file needs to be released to 
Hermes. With the current solution, embedded in the HermesAgent, after a 
period of time the session is closed and no more operations can be performed 
until a new login is made. But what if the timeout is passed because the 
InDesign file is still being converted into a very huge EPS. When InDesign 
finishes the EPS build, it is ready to send data, but the server closes the 
session. Also the setting of a very high timeout value does not solve the 
problem. Note also that this is a "must have" during the currently performed 
demos. 
2. Commercial reason 

Unisys will release the Integration Platform with a separate licensing policy and with a 
different price. 



5 Conclusion 

It has been pointed out that the Hermes Integration Platform needs an HTTP service to 
work and the solution proposed at IFRA 2002 based on the HermesAgent has produced 
some important results. Furthermore, the initial requirement was to reuse an existing 
Hermes Web implementation. 
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1 References 

This functional specification refers to Database Format Field 3PI project. 

2 Functional Overview 

In order to store information relevant to third party native applications of objects/pages 
to be retrieved from the Hermes database, a string field will be added to the pages table 
of the Hermes database. 

2.1 Major functions 

Availability of a string field in the Hermes database, where the mime type of the 
application that creates the external page/content will be stored. 

2.2 Data/Activity Diagram 

Not applicable. 

2.3 Assumptions and Dependencies 

2.4 Migration, Compatibility and Co-existence 

This functionality will be implemented as part of the overall Unisys Publishing 
Solutions environment. 

New functionality must remain compatible with prior versions of software. 
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3 Functional Description 

Third party applications store their content in Hermes by placing the native format file 
onto the file system. In order to allow Hermes clients to show the content of pages and 
objects created by third party applications, a preview of the page/object is generated 
and stored in Hermes along with the native file. 

If required, the native file can be reloaded in the originating application in order to be 
modified. 

In order to store information able to identify the third parties native applications so 
that, when retrieving object/pages from the Hermes database with Hermes Explorer 
this information is shown in the Browse pane, a string field will be added to the pages 
table in the DB. 



3.1 The Database Format Field 



3.1.1 Description 

A string field will be added to the pages table of the Hermes database to store the mime 
type of the application that creates the external page/object. 

The mime type will be used to uniquely identify the external application. This will 
allow to have this information (object/page origin) displayed in the format fields of the 
Hermes Explorer Browse pane when retrieving pages. 



Unisys Proprietary _. Database Format Field 

4 Information for User Manual 

This functional specification, once approved, will be used by the technical writers to 
create the updates for the User Manual. 

5 Performance 

5.1 Speed 

There will not be degradation in speed due to the implementation of this enhancement. 

5.2 Reliability, Availability and Maintainability 

There will not be degradation in reliability, availability and/or maintainability due to 
the implementation of this enhancement. 



5.3 Capacity 

There will not be degradation in capacity due to the implementation of this 
enhancement. 



6 Installation 

Not applicable, as this is an enhancement request to an existing product with 
established installation and trouble-shooting procedures. 
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1 Introduction 



Unisys 



This document describes the new Hermes WEB Services API developed to 
mSonPlStta COmP ° nentS "* ^ " 3 PTOgrammere for 
Although this document is subject to changes since the API specification is 
sti under development, the basic infrastructure concepts here described 
rntigST bC ^ f ° r buildin S a Prototype of the 

This document deals with the process of creating, saving, releasing and 
loaduig pages between Adobe InDesign, InCopy objects and e-Editorial 
News Content Manager. 

2 References 

Table I Referenced specification and standards 



| Description 


Reference 


SOAP 

Specification 
version 1.3 


http://w3 .ore/soap ^^^^^^^^^^m 


OpenSSL 
specification 
and downloads 


htto://www.openssLorpr 


Multipart 
messages 


httD://ietfore/rfc.html RFP 91*7 


IANA official 
registered 
mime types 


htto ://www.iana .org 


OPI 1.3 
specification 


http.//partners.adobe.com/asn/developer/pdfs/tn/OPM3.pdf 


OPI 2.0 
Specification 


http.//partners.adobe.com/asn/deveJoper/pdfs/tn/5660.OPI_2.0.pdf 


Adobe XMP 

technology 

specification 


http://partners.adobe.com/ 


The Unified 
Modelling 
Language 
specification 
version 2.0 


http^AAWw.rational.com 
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3 Definitions, Acronyms and 
Abbreviations 





Acronym 


Definition 




Inter Process Communication 


WSDL 


Web Services Definition Language 


RPC ~ 


Remote Procedure Call 


SOAP 


Simple Object Access Protocol 


HTTP 


Hyper Text Transmission Protocol 


HTTP-S 


Hyper Text Transmission Protocol - 
with data encryption 


SSL 


Secure Socket Layer 


XML 


Extensible Markup Language 



4 Document Conventions 



The following typographical characters are used to identify the examples 
shown in this document- 



courier bold 



elements written in courier bold indicate 
code fragments 



5 Abstract 

The API implements a subset of the SOAP specification. 

The WSDL support is currently under evaluation and, if required, it will be 

introduced in further developments. 

For a complete discussion about RPC with SOAP, see the reference table. 
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6 Motivation 

The creation of this new API is due to the need to make Adobe applications 
more tightly integrated wnh the Unisys e-Editorial Applications. 

7 Introductory statement 

eEditorial saves InDesign documents as logical pages and InCopy objects 
as external objects". In onier to complete the pagination within f the 
Hermes editorial system and to be tightly integrated with it, Hermes SOAP 
ftamework will provide a set of API to allow InDesign to create logical 
pages and InCopy to create objects in News Content Management 



8 Overall architecture 

Adobe InDesign and InCopy will be extended with plug-ins to perform a 
complete interaction with Heimes Editorial System. Following is a high- 
level use case diagram relevant to the InCopy integration. 

Figure 1 High-level use case diagram for InCopy integration 
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Adobe InDesign is extended to support operation on pages. A high-level 
use case diagram for InDesign integration is provided below 

Figure 3 - High-level use case diagram for InDesign integration 



O O CD 




Page Grids ReIe asePage Link Object 



9 General concepts 

Attached to this document is the XML schema of the data types, parameters 
and method calls. Readers must refer to the schema file in order to con-ectly 
identify their representation. 

e-Editorial SOAP methods are mapped to the hem namespace, thus each 
method name will have the "hem" prefix, as well as the response. 

9.1 Requests 

A request is carried out by an HTTP message that contains, in the header 
the SOAPAction attribute. 

The SOAPAction can have three different values, as depicted in Table 3 
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A typical HTTP header for a request is provided below: 

POST <uri> HTTP/1.1 
Host: XXXXX 

Content-Type: text/xml; charset^utf -8" 
Content - Length : nnnn 
SOAPAction: Hermes SOAP 
SESSXONXD 2 <session_id> 



Table 3 Values for SOAPAction HTTP Header element 



| Value of SOAPAction 


Purpose 


HermesSOAPIiogin 


This value must be used by client when 
accessing the security services for a 
login . 


HermesSOAP 


This value must be used by client when 
accessing every service different from 
login/logout 


HermesSOAPliogout 


This value must be used by client when 
accessing the security services for a 
logout . 



The SESSION© is obtained during the login phase in response to a 
successful login, and must be written in the HTTP header of each method 
call. 

25 a PP Ucation 0311 leverage the common login service by asking to the 

SOAP server for a previously created SESSIONID. Two applications 

running on the same machine will have a single login point 

SOAP requests without the SESSIONID header attribute will be discarded 

without providing any error messages or notifications to the client 

The sequence diagram for the overall request is shown in 
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Figure 5 - Sequence diagram for a SOAP request/response 



■ Client 
tbn 



K3 



: SOAP Endprint 



o 



SOAP Services 



id// [authenticated] send request 

0 1 



| 4: response 

g*- 



2: f( verity header 



3: // [header valid] run 



9-2 Response from the server 

Responses to an e-Editorial SOAP server method call is composed of 2 
sections of the HTTP message. 

The HTTP header contains the HTTP status code, while the body of the 
message will contain the response, which will be either a result or a SOAP 
fault. 

Method response elements are "encoded" as per the W3C recommendation, 
appending the Response word to the called method name. For example, 
the response to the HennesLogin will be HennesLoginResponse. 
Whenever a fault is returned to the caller application, the HTTP header will 
contain http/1.1 200 ok and the body of the message will contain the 
actual fault structured as: 

<SOAP-ENV:Body> 
<SOAP-ENV: Fault> 
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<f aul t codo>SOAP -env : "Error "</f aul t code> 

<faultstring>Doscription</faultotring> 
<detail> 

<message> Hermes Error Message</message> 

<code> Hermes Error Code</oode> 

</detail> 
</SOAP-ENV:Fault> 
</SOAP -EHV : Body > 

Faultcode and faultstring contain respectively the SOAP error code and the 
?OAP error message, as per SOAP specification, and are shown in the 
following table. 

The choice of returning a 200 OK header is due to a mismatch between the 
specifications of HTTP protocol and the SOAP. As per specification, the 
HTTP header 500 Internal Server Error forces clients to ignore the body 
content while the SOAP specification uses the body to return the SOAP 
Fault 



Table 5 - SOAP Fault codes 



| Fault Code 


Fault String 


Description 


100 


Version 
Mismatch 


The call was using an unsupported SOAP 
version. 


200 


Must 

Understand 


An XML element that was not understood by 
the receiver contained an element tagged with 
mustUnderstand="true r \ 


300 


Invalid Request 


The receiving application did not process the 
request because it was incorrectly formed or not 
supported by the application. 


400 


Application 
Faulted 


The receiving application faulted when 
processing the request. The detail element 
contains the application-specific fault. 



Appendix A shows the list of Hemes error code and the relevant error 
messages. 

The SOAP Fault error message element must be used to display a 
warning/error message to the user. The dialog window will display the error 
string and, only if a specific debugging option is set, the error code, used 
for debugging purpose. 

9.3 Quick introduction to the Hermes 
Levels 

In this document the concept of levels is frequently used. The Hermes level 
is identified by a unique number composed of a five bytes in a dotted 
format and represents the level id. 

Hermes levels are comparable to a file system structure. Each level is thus 
specified by a name, which is the fall path from the root level composed of 
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the* concatenation of level names separated by a separator char, typically a 
slash. 

As in the file system, each level has a set of permissions that enable or 
disable functionalities and the possibility of saving, creating or reading 
objects or pages. 

Another important attribute is the level type. Although Hermes uses several 
level types to reference different object types, the level types that should be 
taken into account in this integration are PAGE LEVELS and OBJECT 
LEVELS, respectively enabled to accept logical pages and objects. Based 
on the Hermes configuration, a user can have a default level. If a default 
level has been configured for a specific user, the dialog box that shows 
level names must display the default level name on opening. 
The type of level is identified by the LeveiType element in the schema file. 
Most of the SOAP APIs require a level to be specified, otherwise in 
particular cases, SOAP client applications must supply the LEVEL ID, 
while their user interface must show the level name to the end-user. ! 
The maximum visible depth of Hermes Levels should be 5. 



9.4 Message with attachments 

The body of such a message does not differ from other types of messages 
except for the fact that it is a multipart MIME message and the MIME 
blocks are referenced inside the parameters of the method call. 
The W3C proposed standard for the Message with Attachments does not 
give constraints about the implementation. In this document, an easy to 
implement strategy is proposed. 

When a call to a method that requires the presence of the native file format 
and/or the EPS is performed, there must be always a tag that is used to 
reference the bytes block inside the message content. 
As depicted in the XML schema, whenever a file is exchanged back and 
forth between the Editorial SOAP server and InDesign/InCopy, the relevant 
method call (or the result of a call) will contain an element 
<xxxFoxmatMPindex> with the content equal to the index of the 
message part that will contain that file. 

An example of a call to save the InDesign page with the HennesSavePage 
method call is provided below. 
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Figure 7 - Message with attachments 



NativeFormatMPIndex 



GraphicalFoimatMPIndex 



HTTP Header for the message 



boundary 



SOAP XML Request 



HTTP Header for the block 



boundary 



HTTP Header for the block 





To correctly locate the referenced part in the multipart mime, the content of 
the <XXXFonnatMPIndex> tag is used as if it were the one-based subscript 
of an array of boundaries. The very first boundary (which is the number 
zero) will be the SOAP message body. 

The sample above references the I st boundary in the HTTP message. 
An example of message with upload request attachment is: 

<hem : Henne sS aveOb j ect> 

<Native Forma tMPXndex>l</HativeFormatMPIndex> 
<GraphicalPormatMPladex>2</GraphicalPormatMPIndox> 

</hemiHermesSaveObjeot> 
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SlSw,? 6 mU ?« Pa ? MIME messa « e wiU P roceed ^ specified in the 
2T3?i2?S ^^^with the file name in the header of the block 
and the block enclosed by boundaries. The same message type is used in 
response of HermesGetobject call 

Note: to protect itself from the potential proliferation of EPS, the e- 
Editonal server will associate persistently the name of the EPS sent during 
a Hemessaveobject (release). Thus, subsequent calls to 
^ eSS rj° bjeC u ^ rdeaSe mode must the EPS with the same 

Xt^ I 1 ™ 8 1116 *? Upl ° ad If difFerent ^P^ 31 attachments are 
attached to the message, they must be specified in the message body wift 
the <AdditionalAttaelmeiit> XML tag. The value of this tag will contain 
the index to the block containing the actual attachment 
Umsys is currently considering to adopt the preliminary specification of the 

ZSS Z fr ° m W3C - Currently,^ Specification is a 

proposed standard and the ability of the most used XML parser to accept 
these types of messages is under evaluation ^ 
Messages with attachments are, in the new specification, XML messages 
that are not sent as multipart-mime and that contain the binary part of Se 
attachment inside the XML. ^ F me 

10 Integration Platform Services 
10.1 Security Services 

Security services provide a set of methods to interact with the Hermes 
Security subsystem 

10.1.1 Login 

H^? e login process remains unchanged compared to the previous 
uitegration architecture, the request will be made by calling the 

f^*™^ and VasSiAg same Parameter values as the previous 
request The login request is described in the schema file 
Once the client application has been authenticated by the server, it receives 
the Sessi oaid in a Base64 encoded format, as in the previous version. 

Jr^T ,d L m *f ° eW mtegration architecture, will be referenced by 
the client by setting the HTTP header sessionzd 

SEss?ONirt ent meSSage request ' ^ header ^ s P eci ^ *• 

POST /<uri> HTTP/1.1 
Host: XXXXX 

Content-Type: text/xml; charset='»utf -8" 
Content-Length: nnnn 
SOAPAction: HermesSOAPLogin 
SESSIONJID: 261663 
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Figure 9 Login request - Normal flow 
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k HTTP header 
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5: response [SessionID] 
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The response to a HermesLogin call contains the sessionID and timeout. 
Login response will be: 

<SOAP-ENV:Body> 

<hem:HermesLoginResponse> 

<SessionlD>l293 92</SessionID> 
<Timeout>100</Timeout> 
</hem : Hermes LoginResponse> 
</SOAP-ENV:Body> 

The timeout value must be used by the client application to determine how 
long a session will remain valid and will accept method calls. 
If the user cannot be authenticated by the e-Editorial SOAP server the 
response will be a SOAP-Fault. 

By leveraging the common login service, an application must check the 
status of authentication on a workstation. If one application has been 
previously authenticated by the SOAP server, other applications can obtain 
a valid session id by calling the HermesiaLogged SOAP message 
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10.1.2 Logout 

To logout fix>m the Hemes SOAP server, client application must call the 
HermesLogout SOAP API and pass the sessionid as parameters of the 
message. 

The HTTP SOAPAction header entry must contain the HeraessoA*i.ogout 
value. 



10.2 Object Services 



The following section describes the set of operations that can be performed 
on objects. 



10.2.1 Object creation process 

When the client application needs to create a new object inside the Hermes 
News Content Manager, it calls the HermesCreateObject method and 
passes the required parameters. Before doing so, the client application 
displays a dialog box asking the user to enter at least the following data: 

Level 

Edition 

Object name 

(PubDate) 

After selecting the level from the list obtained by the HermesEnumLaveis 
method call, the client calls the HermesEmunBditions and passes the 
selected level to obtain the list of available editions. If the selected level 
requires a publication date (see PubDate data type definition for details), 
the dialog box must require the user to supply a publication date, which will 
be verified later by the server. 

The client application will supply the type of object as a string identifying 
the MIME type of the application that generates the object 
If the object can be successfully created, the SOAP server will return a 
http 200 ok response and the body will contain the initial status of the 
newly created object. 

The status will be referenced in subsequent calls, for example in the call to 

HermosEuumNextValidStatuses. 
HTTP/1.1 200. Ok 

<SOAP-ENV: Body> 

<hemsHerme0CreateObjoctResponso> 
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<StatusID>12</ StatusID> 
<ObjectID>73774</ObjectID> 
</hom: HermesCreatoOb j ectResponse> 
</ SOAP -BNVi Body > 

If the object cannot be created, a SOAP fault will be returned. 
The Hermes eEditorial server locks the object entry to prevent another 
application from changing its data and metadata until a HennesSaveObject 
method call (or an explicit HermesUnlockOb j ect) is performed with the 
flag UnlockAf ter set to true. (In this case, the client must supply the 
native document). 

Note that if the parameter of the HennesCreateObject Unlock is set to true, 
e-Editorial content server unlocks the object immediately after its creation! 
This can be useful for batch creation processes that need to create several 
objects entries without operating on them. For interactive applications, 
unlocking the page after the creation means that the user cannot save the 
object until it is locked again. 

Tracking applications can monitor the activities on the allocated object also 
if it is locked, thus the metadata are accessible in read-only mode. 
The application must cache the object unique identifier returned by the 
method call in order to use it in future operations such as 
Hermes SaveObj ect and HennesReleaseObject to reference the 
object that is being processed. 
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Figure 1 1 Object creation overall sequence diagram 
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LCieateObfect n a m 9 
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1 
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O 

: SOAPServi^A 



2: // Get root levels 



*0 



4: // Get sublevels 



! 6: // Get Editions L 



8: // Select Editbn 
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— >i 




u 

10: // [required data specified! create object 



12: // Store object ID 



13: // Store Initial status ID 



11: //Create object 



10.2.2 Placing objects into pages 

Objects can be placed into pages only if they have been previously stored in 
tne e-Editonal content management system. 

Local files cannot be placed and saved into the NCM all over again To 
prevent from doing so, the e-Editorial server will discard objects attached to 
a message that are not already inside the storage system 
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In order to place a local file, the client application must call the 

S^ol e ^ JeCt S T ^ After a Successfal ™P«» from Z 
Hermes SOAP Server, the object can be placed into the page. This is to 

allow Hermes Editorial system to keep track of objects usage and for 

further accountability on mem. 

The sequence diagram for the object placement is shown below. 



10.2.3 Saving objects 

The process of saving objects is carried out by the HeraesSav«object 
message When saving it, the object will not be unlocked unless it is 
specified or the UulockAfter element value is set equal to "true" If the 
page is being saved and released, the user must specify the status in which 
the page has to be released. The available statuses can be obtained by 
calling the HermesBnumNextStatusea API, which returns the valid 
System * be m ° Ved to accordin S to tf" 5 e-Editorial workflow 

The process of "saving" or "saving and releasing" objects requires the 
naUve InDesign/InCopy document to be sent by the client application 
Moreover if a release action is being taken, the client application is 
responsible for creating and attaching the relevant EPS'document if 
requn-ed by the workflow. This means that if the user is releasing an 
object/page, the client application must check if the ExtendedStetus 
element is equal to "READY FOR TYPESET". To obtain status 
information, the client application must call the HennesGetStatusData API 
for the status that has been selected by the user. 

The message type used when moving InDesign /EPS files back and forth is 
called a message with attachments and will be discussed in the following 
section. 



10.2.4 Loading Objects 

Opening an object can be achieved through a call to HermesGetObiect 
with the appropriate parameters. 

Typically an object is loaded after a query is performed, either a simple 
level query or a parameterized query. v \ 

Hermes Image Object Types 

I°J-S?!r ^ ST fr0m ^ Hennes ^tabase, the client request must not 
specify the NativeFormat but only the GraphicalFormat This is due to the 
fact that the native format is used only to store and retrieve an external 
object that cannot be handled by Hermes directly. For images, they are of 
common types such as JPEG, TIFF which are to be intended as graphical 



also a ^DpT^r ^ PS forraat j?. used to handIe P^views. Hermes SOAP server accepts 
also a PDF or JPEG as a preview. This format MUST be specified ihthe Format Darameter of 

HermesCreateObject/Page SOAP API. If performance issues will ariseln^ SSl 
format, we can discuss with Woodwing if usin'g a PDF instep St^T^^L 
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10.2.5 Delete Object 

The object deletion is achieved by calling the HermesDeleteObject SOAP 
If <*.>«* is locked, the operation fails and a SOAP fault is 
returned. 

Getting object information 

Information about an object can be retrieved by calling HermesGetObject 
API without specifying the NativeFormat element in the SOAP request 
The returned ^formation set will not contain any attachment but only the 
meta-information of the object. 



10.3 Versioni ng 

Versioning applies only to objects. Client applications must be able to 
retrieve specific versions of objects. By using the HermesGetObject 
method, client applications can retrieve specific versions of an asset by 
specifying the version ID of the object in the VersionlD parameter This 
parameter is not mandatory. If it is not specified, the most recent version is 
retrieved. 

Client applications must supply a GUI component to allow the user to 
choose the version through a menu item such as "Get version". The version 
list will be sorted in a descending order, or last-first 
Under normal operating conditions, the user interlace will not ask the user 
to choose a version. 

To obtain the history of an asset, the client application can call the 
HermesOb jectHistory API 

Previous version of a story can be opened in read only mode. 
The client application must supply a UI dialog to create a new version A 
new version of an object is created whenever the object is released. Refer 
to the Hermessaveob jec t API for details about the release operation. 
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10.4 Page Services 



10.4.1 Logical pages 

10.4.2 Page creation process 

InDesign documents are treated as Hermes Logical Pages 

The creation of logical pages process, as well as their retrieval, is similar to 

the object creation process described in § 10.2.1 

InDesign pages are created by calling the HeraesCreatePage SOAP API 
When the chart ; application needs to create a new page inside the Hermes 
News Content Manager, it calls the HermesCreatePage method and passes 
die required parameters. Before doing so, the client application displays a 
dialog box to ask the user to enter at least the following data- 
Level 
Edition 
Page name 
(PubDate) 

Logical pages can be fetched from the Hermes server only by specifying 
the full qualified path of the page, which is: * s 

LevellD 
Edition 
Page name 
PubDate 

The PageED element that is returned from most of the SOAP calls is used 
internally by Hermes to keep the links in the inheritance tree. Trying to load 
a page by specifying the sole PagelD will result in a page not founc Terror. 
After selecting the level from the list obtained by the HeraeaEnumLevala 
method call the client calls the Herr.aaEau.nBditions and passes the 
selected level to obtain the list of available editions. If the selected level 
requires a publication date (see PubDate data type definition for details) 
die dialog box must require the user to supply a publication date, which wil 
be verified later by the server. 

SfjSS y pli ^ n ^.supply the type of object as a string identifying 
die MIME type of the application that generates the object 

\. p3 Jt^ be successfa % created, the e-Editorial SOAP server will 
return a HTTP 200 Ok response and the body will contain the initial status 
of the newly created page. The status will be referenced in subsequent calls 
for example in the call to HennesGetNextValidStatus 

HTTP/1.1 200 Ok 

<SOAP-ENV:Body> 

<:liemiHerinesCreatePageResp©nse> 

<hems StatusH»12</hemt StatusZD> 
<hem s ob j eotID>73774</h©m s Ob j ectID> 
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If the page cannot be created, a SOAP fault will be returned. 
The e-Editorial server locks the page entry to prevent another application 
from changing its metadata until a Hermes SavePage method call (or an 
explicit HermesUnlockOb ject) is performed with the flag UtalockAf ter 
set to true. (In this case, the client must supply the native document). 
Note that if the parameter of the HermesCreatePage xmiock is set to 
true, e-Editorial content server unlocks the page immediately after its 
creation. This can be useful for batch creation processes that need to create 
several pages entries without operating on them. For interactive 
applications, unlocking the page after the creation means that the user 
cannot save the page until it is locked again. 

Tracking applications can monitor the activities on the allocated pages also 
if it is locked, thus the metadata are accessible in read-only mode. 
The application must cache the page unique identifier returned by the 
method call in order to use it in future operations such as 
HermesSavePage and HermesReleasePage to reference the page that 
is being processed. 

10.4.3 Saving Pages 

The process of saving logical pages is carried out by the Hermes SavePage 
message. When saving it, the page will not be unlocked unless it is 
specified or the UnlockAfter element values set equal to "true". If the 
page is being saved and released, the user must specify the status in which 
the page has to be released. The available statuses can be obtained by 
calling the HermesEnumNextStatuses API, which returns the valid 
status the object can be moved to according to the e-Editorial workflow 
subsystem. 

The process of "saving" or "saving and releasing" pages requires the native 
InDesign/InCopy document to be sent by the client application. 
At each save operation, client application should attach a JPEG preview in 
order to let Hermes display a preview in all other client applications. 
Moreover, if a release action is being taken, the client application is 
responsible for creating and attaching the relevant EPS document if 
required by the workflow. This means that if the user is releasing a page, 
the client application must check if the Extendedstatus element is equal 
to "READY FOR TYPESET". To obtain status information, the client 
application must call the HermesGetStatusData API for the status that 
has been selected by the user. 

If the page contains links to images files that come from the Hermes 
system, OPI comments will be placed in the EPS to reference the path of 
the high-resolution version of the image. Hermes is compliant to the OPI 
standard version 1.3. Although OPI 2.0 is not a yet a market standard, OPI 
version 2.0 comments will be placed in the EPS together with the 1.3 
version. 

For the complete specification of OPI version 1.3 and 2.0, see the 
references table in this document 

The message type used when moving InDesign /EPS files back and forth is 
called a message with attachments and will be discussed in chapter 1.1 
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10.4.4 Linking Object to pages 

™^7fi!° ■ U ° W ? ennes „ to manage the links between objects and 

pages (for example to allow queries such as "list all the objects that are 
linked to a specific page"), the client application must notify the linking 
operation by calling the HermesLinkob j eot SOAP API 

SISASL'T*? linked to a page ' for exam P le when *• * 

already knked to another page, Hermes SOAP Server returns a SOAP Fault 
and the client application must inhibit the placing of objects 

SJfjJT* t0 P . ages / eaUnfcObject API needs to know the 
pageid of the page in which the object is about to be placed. This implies 
that the page must exists in the database. Pages for which 
rSg 8CreatePa9e ^ ^ b6en already 03116(1 must avoid *e object 

10.4.5 Unlinking Object from pages 

must be called. Both APIs need the fuix quaXi* ied page name element 
to be passed as parameters. ' 

10.4.6 Delete Page 

The page deletion is achieved by calling the HermesDeletePage SOAP 
API. If the page is locked, the operation fails and a SOAP fault is returned. 

10.4.7 Page grids 

bl1dec t ter PP,iCati0n CTeate 8 ^ HCnneS Pag6 ' COnect must 
In Hermes each level can have an attribute to indicate that a grid is 
available, the attribute is not set, the grid is taken by the parenfTeve? 

W a SSuTgrlr * *° "* if * ^ ° 0t ^ a * ^ 

^Sh^fS £2? aPPHCati0n ^ for *• Bd* available 
Tins process ensures that the page size is always synchronized with the 
page sizes defined onto the Hermes system. 

To obtain the list of grids names, the client application must use the 
HermesListGridNaates SOAP API call and specify the LevaiiD that the 
application is querying. 

The actual grid loading will be possible by calling the 
HermesLoadPageSrid API, with leveim and grid name as parameters. 



24 



HE70-DS-AIES 



Adobe Integ ration with eEditorial Solutions 

A request for grid name listing will be 

< hem s Herme sBnumGx i dName s > 

<LevelID>l •1.0.0. 0</LovelID> 
< /hem: He rmesEnumGri dName s> 

shows the sequence diagram for the grid name listing operation. 
Figure 13 Listing page grid names 



: lnDe 8iqn ; NewHermes Document niah^ 

I I 



O 



1:// select level I 

>\ 



: SQAP Efldpotnt : SOAPSenJrp 

! I 



2: // [LeveMDJ HpmesEnumGridNames 



3: //[valid 



(no fault] display grid name list 

*0 



I 



I 



request] Query Grid Names 

^ 

I 
I 



The SOAP server response will be: 

<hem : HennesBnumGridNamesResponse> 

<GridName>default</GridName> 

<GridName>layout</GridName> 
</hemsHermesBnumGridHamesRe8pon8e> 

Figure 13 shows the sequence diagram for the page grid loading. 

10.4.7.1 Local page grids 

To enable the user to work with InDesign and InCopy, page grids must be 
available also as a local cached copy. This will follow the previous 
implementation where grids where defined into a local XML file 



10.4.8 Multiple pages 



If an InDesign document contains more than one page and it must be released 
m a status that requires the preview, the client applications must generate the 
Pre 7|f w for each P a 8e in a separate EPS/JPEG file. The entire package of file 
will then be saved using the normal procedures. 

I^^^/^^IJ 0 ' document will contain the InDesign 
native file and a senes of blocks, one for each EPS. 



HE70-DS-AIES 



25 



Adobe Integration with eEditorial Solutions Unisys 



10.5 Edition Services 

Edition services provide access to edition information for a specific 
newspaper. By using the edition services provided by the Hermes SOAP 
server, client application can list edition names and obtain more specific 
information about a particular edition. 

Editions are named and have a zone that enables the inheritance among them. 
For example, there could be an edition named A and an edition named A* that 
inherits from A. This means that pages inside edition A* inherit from pages in 
edition A. 



10.6 Query Services 

Query on pages/objects is performed through the 

HermesQueryPages/HormesQueryObjects call. When querying objects, 

user must be able to specify different parameters in order to refine the 
query and obtain only a list of objects that meet specific requisites. 
Queries parameters are: 

■ Publication date from 

■ Publication date to. This value can be set only if the previous 
one has been entered 

■ Status 

■ Type of object: Images, InCopy, InDesign, Iilustrator,etc (valid 
only for querying objects) 

■ Author 

• Name of object / pages; wildcards are accepted. For the XML 
point of view, wildcards are included in the ANSI set of chars. 

• Every parameter combination can be made and a query with all 
parameters specified can be issued. 

The result set of a HermesQueryOb j ec t/Page call must be displayed 
with at least the following set of metadata: 

• Object type 

• Object Name 

• Author 

• Status 

• Lock State 

The display of the status information is up to die client 
implementation. It is suggested to draw the border of the item of the 
list containing the result with the color associated with the status of the 
object. 
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10.6.1 Page query 

10.6.1.1 General considerations 

by the SOAP server * SpeC,fymg dlfferent Parameters that will be evaluated 
The GUI component is a three-tabbed dialog window. 

10.6.1.2 User Interface 



Figure 15 Page Name tab for page query 




10.6.1.3 Level selection 

The main level selection is made into the <Jm a r*rw. a 

should start with the default tevd rtf ST?T??? * P"* Howw ^ * 
connected. To obtain Sis SLSS^J?***,?* ^ CmTentl y 
HexaesQetusorData "fonnaHon, the application can call the 
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10.6.1.4 Include sublevels 

* 

This option is set via 

<Iacludeaubl e vel3>trtte</lneludeaul>LevelB> 
and enables the query to go through all the siiblevel 

If the user specifies all the 5 levels by selecting values from the relevant 
combo boxes, this option will be hidden 



10.6.1.5 Edition 

The combo box is filled with the edition names. This dataset is obtained by 
calling HermesKnimBditions SOAP method and specifying the level ID 
*or the query purpose the EditioniD must always be used. 

10.6.1.6 Publication Date 

If this option is checked, the date from and to must be filled in. If the date to is 
not set, the current date will be used by default. 

The fields will contain integers specifying valid dates number. At the moment, 
we assume that the date to be entered will have the following format: 

MMDDYY 



10.6.1.7 Page being modified 

Whetfa f ? 6 , qUeiy wiU ««* fo ' W8" currently being 
modified (locked) or not (unlocked). e 

Additionally, the user can specify the username of the user being modifying 

St^ 8e ^u 08,1 b 5 3Ch,eVed by either enterin 8 <*« username manually or 
selecting the browse button. * 

Clicking die browse button will result in a call to HermesEnumTJsers SOAP 

X SiU" ^uu WiU , be < ¥ Splayed m a Ust box a se Parate dialog box. 
rhe hst box will be single-selection. 

This parameter is set with the <Modif ying> tag in the request 
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10.6.1.8 Workflow 

It is always possible to specify the status of the pages to be searched in order 
to filter the pages found in a different status. This list is multi-selection thus 
allowing the user to select one or more statuses. In the query, this corresponds 
to a space-separated list values of the <StatusDD>tag. 

Figure 17 User Info tab for page query 




10.6.1.9 Creator 

The usemame field corresponds to the <Creator> tag in the request and the 
behavior is the same as in previous page (Page being modified option). 
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10.6.1.10 Creation date range and 
Modification date range 



Figure 1 9 Page info tab for page query 




1 0.6.1 .1 1 Metadata search 

ISi^ mder definiti °« because involves the XMP technology 
aspect and the ability to define custom fields and field prompt ^ 
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11 Concurrent operations 



Hermes is a collaborative environment that allows multiple users to work 
on the same page. Client application can paginate or, generally, use objects 
only if they are not being'used by others. Before the client application can 
make use of an object, it must query its Locking Status to verify that the 
object is not locked. 

To verify the locking status of an object or page, client application can call 
the Hermeslaobjectliocked (or Hermes I sPageLo eked) with the 
object/page ID of the object or page to be checked. An example could be: 

Figure 21 Testing the lock status before adding objects to page 



: InQesiqp 
I 



: Query Result 



1: // drag an asset 



3: [object is not locked] // insert object in 

0 ' u 



: SOAP Endpoint 
I 



y 2: // HermeslsObjectLoc ked I 
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12 Event Management 

Client applications must be compliant with the Heimes editorial system 
JZLTSSr* and . traCldng - Events » "notifications" <£*25 
wffJSl! ° Perat,0nS BM,d0 * clients mt0 *■ Hennes system. 
Sitf ""^r 68 311 6Vent * must me ^formation pertaining to 

the object or page the event is relevant to gro 

faCoovXlC ^fTT ^ StatUS ° f a P a 8 e/ob J ect °P<med in InDesign / 
UiCopy, mac must update the status information. 

re ° eiVed fr ° m *» common application running on the 

2Ti ^IT" eV6nt iS reCeived ' * is p0Sted to * e applteation 
via a PostMessage on Windows and via the IPC (mter Process 
Communication) on Macintosh. rrocess 

13 Messaging 

Hennes editorial system allows various clients on the network to 
collaborate via instant messaging, alerts and mail, the latter Soa^ 
private proprietary mailing system. 

S^IoTfn — m needS to 800688 *» waging service will call the 
common login via a shortcut. 

14 Secure HTTP 

hi order to keep information safe and secure over the network, the Hennes 
environments the encryption on the proprietary protocol 

Hro^S^A T 6 leVCl ° f SeCurit * communication over the 
HTTP transport can be kept secure using the Secure Socket Layer 
Secure connections respond to the same endpoint on a different port This 
opZw t0 * ^ ^ section to perfornf SOAP 

Sf.f^ te . U8 fS « fifely available client library, called OpenSSL 

SSS? 38 t0 , i 3 80od implementation of the HTTPS 
standard. OpenSSL is available at http://www.np *n gc l n T 

Clients using the LibWWW library to manage the HTTP connection can 
toke advantage of the internal SSL implementation. 

sSiiSrS Pr ° Vid l mtegrators with cIi »t certificates in order to use 
SSL over HTTP connection to perform SOAP interactions 

15 Managed Asset Types 

S5^2f!r l^^^rent types of application-specific objects. 
Different pages or objects can be generated by different type of aonlications 
resulting m a set of object/page types that can vary among^nfigmatiom A 
chent apphcauon that is able to perform advanced qp^oaSTS^ 
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database must be able to offer to the user the ability to select which type of 
asset to be queried, for example: 

"List all the objects in a certain status and generated by InCopy and Illustrator " 

To provide this "registry" information that can be used to show the list of 
managed asset types, Hermes SOAP server offers the 
HermesEnumAsaetTypes API. The result is a list of application names/ 
asset category pair which can be used to fill listboxes etc. Hermes SOAP will 
return all the managed as.set types. The client application should filter this list 
to present only the assets that can be inserted or imported into the application. 



16 Moving / Copying objects and 
pages 

Client applications must be able to move and/or copy InDesign pages and 
InCopy object among levels. The SOAP API for copy does not differ fiom the 
one used to move an object/page except for the "Operation" parameter which 
must be equal to copy for a copy operation. 

By default, the HermesMoveObject/HermesMovePage SOAP API moves me 
asset from one level / edition to another, deleting the content of the source 
object/page. i 



17 Metadata 

For each type of object, the user must be able to change metadata such as the 
Author, content type, etc, XMP technology will be used for embedding 
metadata into InDesign pages or. InCopy stories. Client application must 
supply a Ui component to allow the user to change metadata. 

The list of editable metadata is shown in the following table: 

Table 7 Table of minimum required metadata 



Attribute name 


Attribute type 


Applicability . 


Author name 


String 


Objects/pages 


Comment 


string 


Objects/pages 


Content description 


String 


Objects/pages 
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18 Plugin Specific Functionalities 

18.1 Dummy Text 

InCopy texts can be placed into the page regardless of the Hermes status 

iZJZlTT* ^ ? ? e databaSC - H ° Wever « some statuses P^ent 
fSJZV ^ Tf ^ eWed fa ° rder t0 aUow P a S e designs working with 

Sfl ^T 1 ' faC ° Py ° bjeCt * at 816 not m a status Just be 

shown with a dummy text. 

??£U?T ^ C ° Py , ° bjCCt * reIeased m a status as READY FOR 
lYFBSET, the real text can be inserted in the relevant text fame 

cit^f^S^S" queiy Ae current status "extended status" to 
search for the "visibility" of the content. 

InCopy must deny the opening of a story which is not in the "Ready for 
typeset status. 

ff f w P r? 6WS PK)dUCed by InDesi 8 n wiU not «veal the content 

of a tract story with dummy text. 

18.2 Text conversion between InCopy 
and Newsroom 

When a Hennes textual object such as a headline or an article is placed into an 

° P * ltaO0By ' Client a PP licatioa will receive a flat 

Sfl » S ♦ * 6 meSSage / es P° nse - ^e response to the HermesGetObject 
call will contain an attachment of type text Depending on the action 
performed in the specific apphcation, the object is linked or inverted 
followmg the rules below: convened 

When the user drags and drops a Newsroom textual object, InCopy 
will import a flat version of the Newsroom text, without markup 
commands and text styles and convert the text into a new InCopy 

When the user drags and drops a Newsroom textual object into 
MDesign, the plugin should create a new InCopy object with the 
content read from the Newsroom object 
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I- Appendix A: Fault codes 



Table 9 Fault codes and messages 



Code 



Message 



Object not found 



-14 



-40 



-41 

-42 



-43 
-150 



Layout not found 
Page not found 



Level error 



Level Not Found 



Invalid Level Typ e 



Invalid Data 



-152 



-153 



-154 



Initial Status Error 



Status attribute error 
Status Error 



Status Not Found 



Undefined Status 



-1000 
-1001 



Timeout 



Deadlock 



Database Error 



-204 
-207 



-211 



-212 



-213 
-214 



-215 



Query Syntax Error 



Invalid Location 



Not Logged In 



Invalid Edition ID 
Invalid Edition 



Invalid Master Edition 



Invalid Edition Time 
Invalid Edition Zone 
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II- Appendix B - User Interface 

This section shows some examples of GUI components used in the Hennes 
environment. Although the plug-in user interface shall be slightly different 
from the examples below, all the fields described must be used. Moreover 
Unisys suggests to dispose the fields as shown, in order to provide a way to 
work that is not very different from the Hermes one. 



A. Query object options dialog 

The query option dialog box is invoked by me client application whenever 
users want to specify additional criteria to retrieve objects from the Hermes 
News Content Manager repository. 



Figure 23 The Query Object option dialog box 
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B. Query Pages options 

Figure 25 The Query Page option dialog box 




HE70-DS-AIES 



37 



Adobe Integration with eEditorial Solutions umsvs 



Figure 26 Dates and ownership query dialog tab 




C. Release Page/Object 

Figure 29 Sample release object -page dialog 
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D. Object history 

Argument under specification. 
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Element actions 


The subject symbols are symbols that are used to 
quickly find a subject among the large mass of 
information of a newspaper. Symbols are organized 
according to a hierarchical tree that envisages a 
Parent/Child Peer to Peer relationship. 


upens a dialog window to insert all the data to create a 
new page into the database (similar to the "New" 
functionality of Word) 


upens a dialog window to insert all the data to open an 
existing page from the database (similar to the "Open" 
functionality of Word) 


1 o save the active page into the database 


I his action changes the status of a page in the system. 


I o close without saving the open page 


Opens a dialog window to insert all the data to create a 
new object (text, headline, table etc..) in the database 
[similar to the "New* functionality of Word) 


jpens a dialog window to insert all the data to open an 
existing object (text, headline, table etc..) from the 
iatabase (similar to the "Open" functionality of Word) 
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To save the active object in the database 


This action changes the status of an object in the 
system. 


To close without saving the active object 


The "typeset* is a particular kind of print functionality, 
different by the normal print on a local printer (i.e. a 
common laser printer), it is the final printing process, in 
this case the page is sent to the newspaper printing 
press. 


Same as Typeset page" 


Header of page deleted 


Footer of the page deleted 


Opens a stand alone window that contains the selected 
object. 


This functionality allows the user to lock the edition in 
order to disable any other user modifications. 
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1 References 



This functional specification refers to Third Parties Integration with NewsRoom 
Editorial Enhancement. 



2 Functional Overview 



The integration of third parties applications with the Hermes applications will imply 
some changes in the Hermes NewsRoom module, in order to handle pages coming 
from external applications. 



2.1 Major functions 

NewsRoom will be modified in order to be capable to read and edit pages created with 
third parties application and specifically with the Adobe InDesign application. 



2.2 Data/Activity Diagram 



creates new objects 



launches NRoom 




User 



saves external page 



Hermes 
DB 



saves page with new Nroora objects 
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2.3 Assumptions and Dependencies 

• The figures depicted in this document are dummy screenshots. 

• The GUI of all new dialog windows/controls implemented must be XP-like style. 

• Previous NewsRoom behavior to handle pages coming from Hermes will be 
maintained 



2.4 Migration, Compatibility and Co-existence 

This functionality will be implemented as part of the overall Unisys Publishing 
Solutions environment 
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3 Functional Description 

The integration of third parties applications with the Hermes editorial systems requires 
the Hermes modules to be partially modified in order to interact with external 
applications. 

This project aims at modifying the NewsRoom behavior so that this module is capable 
to handle pages coming from external applications and, specifically, from Adobe 
InDesign application. 



3.1 Handling external pages in NewsRoom 



3.1.1 Description 

Pages coming from external applications will be imported in NewsRoom and handled 
as images that will be used as a background of the NewsRoom logical page. External 
pages will be treated as image type objects and users will not be able to modify them. 
The image displayed as background will be generated using a preview of the external 
page. 

Once an external page is imported and displayed as background of a Newsroom page, 
users will be able to take actions such as creating new objects, saving, etc., as currently 
occurs when working on a standard NewsRoom page. 

If the page is open in Layout mode the page grid will overlap the external page. The 
overlapping of the grid will be transparent, thus allowing users to see the objects 
making part of the external page. In this way, users will be able to create new objects in 
NewsRoom by taking into consideration the already existing objects while designing 
new elements. 

The NewsRoom page will be composed of different layers: the external page (along 
with its objects) in the background, the page grid (if displayed) in the middle, and the 
new NewsRoom objects (if any) displayed in the foreground. This means that it will 
not be possible to create layout that automatically clip the external page layouts. 
Newsroom elements added to the page will overlap the EPS representing the preview 
of the external page. 

XMP technology will be vised for embedding metadata into InDesign and IhCopy 
objects. 
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Figure 1 - Example of Newsroom page open in Layout mode with background external 
page 
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Figure 2 - Example of Newsroom page open in preview mode with background external 
page 



■IS" HERr^ESGO: CP) T EST-D0UAI-VILLE-ACTUALIT.50C-TEST-TEST <DEMQ1> ..."T^/XZ/OZ 



Quosijirm forioriiis, ma, quann patalu- 
dem octu consiciondam fur hos co per- 
rit: iarn ena, C. condom perei pub! in. 




HE70-FS-TPIN 



9 



Third Parties Integration with NewsRoom 



Unisys Proprietary 



4 Information for User Manual 



This functional specification, once approved, will be used by the technical writers to 
create the updates for the User Manual. 



5 Performance 

5.1 Speed 

There will not be degradation in speed due to the implementation of this enhancement. 

5.2 Reliability, Availability and Maintainability 

There will not be degradation in reliability, availability and/or maintainability due to 
the implementation of this enhancement. 



5.3 Capacity 



There will not be degradation in capacity due to the implementation of this 
enhancement. 



6 Installation 

Not applicable, as this is an enhancement request to an existing product with 
established installation and trouble-shooting procedures. 
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1 References 

This functional specification refers to Workflow Definition for External Objects 
Editorial Enhancement EE-2002-03. 

For the description of the functions available when defining Hermes pages and objects 
workflow using the NrConfig module, refer to the NrConfig User Manual (HEXX- 
DOC-NRCUM) 

2 Functional Overview 

The integration of third parties applications with the Hermes applications will imply 
some changes in the Hermes NrConfig module, in order to allow handling objects 
coming from external applications, so that a specific workflow can be appropriately 
defined for them. 

2.1 Major functions 

Capability to define a specific workflow for objects created with third parties 
applications, so that they can enter and follow all the production phases as currently 
occurs for standard objects and pages created with Hermes client applications. 



2.2 Data/Activity Diagram 

Not applicable. 

2.3 Assumptions and Dependencies 

• The figures depicted in this document are dummy screenshots. 

• The GUI of all new dialog windows/controls implemented must be XP-like style. 

• The current functions used to define the workflow for Hermes objects/pages will 
not vary. The workflow of external objects will be defined using the same 
functions available for Hermes objects. 
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2.4 Migration, Compatibility and Co-existence 

This functionality will be implemented as part of the overall Unisys Publishing 
Solutions environment. 
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3 Functional Description 



The integration of third parties applications with the Hermes editorial systems requires 
the Hermes modules to be partially modified in order to interact with external 
applications. 

This project aims at modifying the NrConfig behavior so that this module is capable to 
handle objects coming from external applications, thus allowing users to define a 
specific workflow by dividing the production into several steps, from the object initial 
creation to the final completion. 

3.1 Defining a workflow for external objects 
3.1.1 Description 

As already available for Hermes objects and pages, users will access the Nrconfig 
module to define a specific workflow also for objects coming from third party 
applications. 

Users will click on the T Designer icon or select Configurations Workflow to 
access the Copyflow designer tabbed dialog window. 

In order to handle external objects, a new tab will be added to this dialog window, as 
depicted in the figure below. 

Figure 1 - The External Objects tab t 
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Users will use this tab in the same way the relevant tabs are used for Hermes objects 
and pages. 

It will be possible to define statuses for external objects by selecting the New Status 
radio button and drawing the circles corresponding to the status being defined. 
Users will then be able to define the entry conditions and the attributes for each of the 
designed statuses by enabling the Select radio button that will display the Object 
Status Parameters dialog window. 



By using this dialog window, users will also be able to associate a color with each 
defined status by clicking the relevant button and selecting a color from the displayed 
dialog window. 

In addition, it will be possible to specify the user the object released in the defined 
status must be sent to, through the list of users displayed in a separate window when 
clicking the Users button. . 

Of course, the External Objects tab will also allow to define transitions between the 
statuses the object will move to {Transition radio button) and delete statuses {Delete 
button). 

In addition, it will be possible to copy the workflow defined for Hermes objects and 
use it for external objects. 



Figure 2 - The Object Status Parameters dialog window 
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4 Information for User Manual 

This functional specification, once approved, will.be used by the technical writers to 
create the updates for the User Manual. * 

5 Performance 
5.1 Speed 

There will not be degradation in speed due to the implementation of this enhancement. 



5.2 Reliability, Availability and Maintainability 

There will not be degradation in reliability, availability and/or maintainability due to 
the implementation of this enhancement. 



5.3 Capacity 

There will not be degradation in capacity due to the implementation of this 
enhancement. 



6 Installation 

Not applicable, as this is an enhancement request to an existing product with 
established installation and trouble-shooting procedures. 
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1. Introduction 

This document describes a possible scenario for the integration of Adobe applications with 
the Hermes editorial system, considering InDesign as the pagination tool and InCopy as the 
text editor. 

Main goal of this document is to describe the technical architecture, layout the required 
functionality, highlight potential problems and limitations and provide a basis for a detailed 
technical evaluation/design to be performed by the development team(s) (internal and 
external). 

1.1. Benefits 

This approach will merge the high-end graphic functionalities of InDesign with the 
production capabilities of the NCM-Hermes Publishing system, and Adobe 
applications will become a viable alternative to Unisys tools. 

Major benefits: 

• Users will have the possibility of choosing InDesign or NewsRoom to create 
pages; 

• Integration will be available on both Windows and Mac platform; 

• No more conflicts between features compatible and not compatible with 
NewsRoom; 

• Editorial content will be accessible from InDesign and InCopy; 

• Supervisor will remain as the main production tool for managing editions and 
output; 

• NewsPlanner will remain available as the news-planning tool; 

• Hermes workflow will remain and will be available in InDesign and InCopy; 

• The solution with NewsRoom entirely replaced with Adobe tools will be 
appealing to magazines. 

1.2. Limitations 

Some limitations of the integration (that is, Hermes features that will not be available 
in InDesign) are listed below: the list should not be intended as definitive, given that 
viable alternatives may be found using InDesign features or by incorporating third 
party plugins (see http://idvlueins.com/catalavr/, http://theDlumnsite.com ). 

Inheritance of pages and objects between editions 
Jump stories 

Automatic fields (e.g. jump lines, folios) 
Vertical copyfit 

Pagination tools (e.g. grow, snap, move, etc.) 
Messaging 
Autolink 
Indexing tools 
Language support (*) 

(*) While InDesign is currently available in all the most important languages, 
(different versions will ship at different times) InCopy is currently available only in 
English, French, German, Italian, Spanish, and Swedish: Adobe mentioned the 
possibility of adding language support where strongly required. 
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Besides these, the integration as described below, is only focusing on how these 
Adobe tools can be integrated into the overall UNISYS publishing solution. It does 
not cover any client related function, that is possibly required to make InCopy and 
especially InDesign a more productive tool and more applicable in the newspaper 
environment 



2. System architecture 

2.1. Integration overview 

This integration follows a different approach from what is available in Release 6.0: it 
is more focused on making InDesign and InCopy part of the suite of Hermes tools, 
allowing them to access content stored in the database, save pages and stories in the 
database, support workflows, user permissions and profiles. 

It is less focused in making InDesign and NewsRoom closer or more "compatible". 
An effort has to be done to avoid replicating features in NewsRoom: in fact, the two 
applications will remain and will coexist with a limited interaction. 

Usage of a "neutral" layer to communicate with Hermes will be kept: the application 
will use an XML-based protocol to manage metadata information back and forth from 
the database. 

Basically, the idea is to give InDesign the capability of creating "logical pages" in 
Hermes: these will be distinct from pages created with NewsRoom, and will be 
managed by InDesign only. Using InDesign, pages can be created with the 
contribution of other Adobe tools (e.g. Photoshop, Illustrator), with InCopy playing a 
main role as the text editor: these pages will be managed using Supervisor (eventually 
will be merged with other logical pages) and will be part of the production workflow. 

A very important aspect of this integration is, that we will not loose our main concept 
in Hermes of being able to modify pages and object at the same time by different 
people. As this is not a standard functionality of InDesign and InCopy, it needs to be 
implemented as part of the plugin. WoodWing (our development partner) indicated, 
that they have such a plugin (based on file system) available, which we have 
evaluated and it seems to be the right starting point for this integration. 

We will then have a new separate production process with a second set of tools, 
merging with the traditional one in the Supervisor. In this scenario, pages (and 
objects) can only be modified with the tool that was used for the page (object) 
creation. Moreover, exchange of textual content between Hermes and Adobe tools 
will be based on "copies" of the content itself: a conversion will be required (with a 
risk for limitations) and workflow features (lock/unlock, statuses and permissions) 
have to be careftdly maintained. 
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2.1.1. The following platform-related scenarios will then be 
available: 

Windows-based scenario: 



Department 


Applications \ 


Editorial 


InCopy, NewsRoom, UPS-Explorer 
(NGM) 


Photo 


Photoshop 


Layout 


InDestqn. NewsRoom 


Production 


Supervisor, UPS-Explorer 



Mac-based scenario: 



Department 


Applications 


Editorial 


IriCopy, NGM-Web 


Photo 


Photoshop 


Layout 


InDesign 


Production 


Supervisor, UPS-Explorer (Windows) 



2.1.2. Copy-driven workflow 

The diagram below shows, how this integration supports copy-driven 
workflow scenarios. ' 
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Story creation: texts can be created using either NewsRoom or InCopy, 
and saved in Hermes database. In both cases, News Gathering Manager can 
be used to access wires or contributions from reporters (on the Mac, the 
browser-based client can be used). It will be possible to import texts created 
with NewsRoom in InCopy. 

Photo input: all the tools available today will remain available and will be 
used to import images and graphic files in the Hermes system (database and 
filesystem). 

Page design: pages (Hermes logical pages) can be created using either 
NewsRoom or InDesign, and saved in Hermes database. InCopy texts can be 
paginated in InDesign without composition problems, due to the integration 
between the two applications. Images stored in the Hermes database will be 
paginated, using the low-res version, and proper OPI links to high-res files 
will be inserted. 

Edition planning, final output: Supervisor will be used, as today, to 
manage publications, editions and to drive final output of all pages: from the 
Supervisor, it will be possible to mix logical pages created with InDesign and 
NewsRoom, and to track the production of all the pages in the system. 
Supervisor will remain available on Windows only, while the tracking 
functionalities will be accessible from the Mac using the browser-based 
client. 

2.1.3. Layout driven workflow 

Fully supported by the integration. It will be possible to design a page first, 
then assign the various text containers (also complex containers with several 
elements) to different InCopy objects: editors assigned to write a story will 
open the text object only, with the layout designed in page, and will write to 
fit. InDesign and InCopy use the same composition engine, therefore 
hyphenation, line endings and all the typographical aspects will be 
maintained. 
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2.2. Architecture overview 



Various integration components will communicate with the server (and the database) 
in different ways, summarized in the diagram below: 



NewsRoom 



Supervisor 
TCP-IP, HRAS protocol J 




Adobe 




Adobe 


InCopy 




InDesign 


\ 




t 


i HTTP, XML-based protocol | 



Loglnserver 










Hermes 


HRAS 


< — 


► 


WebAgent 




Hermes DB 



Hermes 
FileSystem 



While Hermes applications, like NewsRoom and Supervisor, will continue to 
communicate directly with server applications (typically HRAS and Loginserver), 
relying on TCP-IP and HRAS protocol, Adobe applications will follow a different 
path. 

InCopy and InDesign will not "talk" directly with server processes, but will 
communicate with Hermes Web Agent, a new server module introduced in Release 
6.0 to manage communication with Web clients. Hermes Web Agent, in turn, will be 
connected with HRAS and LoginServer to accomplish user validation and database 
access. 

InCopy and InDesign will rely on the XML protocol, HTTP-based, already 
introduced in Release 6.0: it is platform independent, ensuring that the integration 
will be available on Macs, and successfully used in current implementation. 

2.3. Integration components 

The diagram below collects all the actors of the integration and the objects managed 
by the applications. 

Hermes database plays a central role as the common repository for content and 
metadata used both by Hermes client applications (e.g. NewsRoom, Supervisor, etc.) 
and by Adobe programs (InDesign, InCopy). Applications interested by the 
integration are on the two sides of the diagram: Photoshop is already integrated with 
Hermes. Illustrator and AlterCast, even if mentioned in this document because of 
their potential roles, are not included in this phase. 
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The database stores: 



Graphic files, either imported or saved using Photoshop, to be paginated 
either with InDesign or NewsRoom; 

NewsRoom texts, to be paginated with NewsRoom or to be imported in 
InCopy and paginated with InDesign; 
InCopy texts, to be paginated with InDesign; 
NewsRoom logical pages; 
InDesign logical pages; 

Physical pages created from logical pages, even from merging NewsRoom 
and InDesign logical pages; 
Edition information. 



InDesign 



InCopy 



Photoshop 



Hflrmns database* 



InCopy 




Images, 


texts 




EPS flies 





Supervisor 



UPS-Explorer 



Ad Interface 



Event Mngr. 



Output/OPI 

Mnar. 



Supervisor manages output for print editions, while content can be extracted for 
archiving or re-purposing in digital format. 

2.4. New developments 

The architecture introduced above includes standard and new components: the 
following is a list of the most significant new developments required by this 
architecture. 



2.4.1. Hermes palette tool 

This application will be available in both InDesign and InCopy as a palette 
and will provide access to Hermes database, respecting workflow and user 
permissions. It will resemble NewsRoom "makeup window", listing object 
and pages, displaying previews, opening items via drag & drop, etc. It will 
communicate with Hermes Web Agent to access Hermes. 
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The following list contains the functionalities required: 

Search: The palette should provide an simple feast search function 

capable of defining searches on all important fields like 

o Object/Page name 

o Level 

o Publication date 
o Author 
o Status 

o Type (INDD, INCD first, then image/graphic objects, last 
NR textual objects) 

In addition to this fast search, a more complex/extended search 
should be possible providing the same search functionality as the 
UPS Explorer currently provides. In addition to the fields mentioned 
above, the following fields should be accessible: 

o Object/Page comment 

o Edition 

o Creation, Modification, Modifying users and intervalls 
o Workflow fields (used, locked, in page, outside page, 
deleted) 

For InDesign page, some additional search options should be 
implemented: 

o Pages plus all attached objects (INCD and image/graphic 
objects) 

The palette itself should support different sorting options, preferably 
by clicking into the table header field. The fields available for display 
should be configurable. 

Link: The palette is the main tool to paginate objects onto InDesign 
pages. This tool should implement the following functions, 
o Link INCD elements to a INDD page: This function will 
place the INCD document onto the INDD page by 
establishing a link (like in WoodWing smart connections). 
The UPS database needs to be updated immediately after this 
action, so the INCD object can be marked as "Paginated", 
o link NR image/graphic elements to a INDD page: This < 
function will place the image/graphic object as it is. The UPS 
database needs to be updated immediately after this action, 
so the object can be marked as "Paginated" The low-res 
image has to be passed to INDD. During output, the low-res 
path has to be converted into the hires path before the 
OPIFILTER is running and processing the file. 

Unlink object: The object needs to be marked as "Available" again in 
the UPS database. 

Open INCD object or INDD page: By using drag&drop onto the 
desktop, either the object or the page should be opened in the 
application. The UPS database needs to be updated immediately after 
this action, so the object/page can be marked as "Locked". 
Delete INCD object or INDD page: The UPS database needs to be 
updated immediately after this action, so the object/page can be 
marked as "Deleted". 
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2.4.2. InCopy/lnDesign plugins 

S!rf^ ltl0 ri 0 thC * ove - m «tioned functions, the following list of 
funcUonahties needs to be provided within Inbesi^ 3o P y 

• Create new INDD page: Like in the existing plugin. a new «.«. 

• Release INDD page: TTiig function should 

o "^"BoSootteaatus.erealeanEPSandlodcalllNCD 

the UPS server. c UNUU aoc need to be transferred to 

' 2Sf document: This function should update the 1NCD 
object record accordingly and unlock the object record 

• Move/copy INDD or INCD object- 

• Unlock INCD or INDD object: 

• Change status of INCD or INDD object- 
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To show with a simple example, let's assume a single page has been created using 
InDesign and has been save in the database. From this point on: 

InDesignpage Hermes Supervisor Output 

I . Logical page Logical page(s) Physical page 




XMUPDFfile 



Archive or re-purposing 



Multiple logical pages: When the multi-page document is completed, it 
needs to be saved in Hermes as several logical pages. The user will be 
prompted for as many logical pages as pages in the InDesign document for 
each logical page, an EPS and a preview will be generated (the multi-page 
EPS will be split in several EPS files, this is supported by InDesign). XML 
and PDF versions will be generated as well. 



2.4.3. Hermes Web Agent 

This application will be enhanced - where needed - in order to fulfil all the 
need of the integration. New functionalities maybe added (e.g. create new 
page) and exiting ones will be improved (e.g. to fully manage workflows). 

3. Database related topics 

3.1. Pages 

3.1.1. Database requirements 

InDesign documents are stored in Hermes as graphical objects, identified by a 
new object type (e.g. INDD_obj): the database entry (as for any graphical 
object) will have a link to the EPS file generated by InDesign, the JPG 
preview and the native INDD file. 

An InDesign document is always associated with (and paginated in) a logical 
page, created automatically when the document is saved in Hermes. To 
enforce the similarity with current NewsRoom behaviour, InDesign will 
always access pages in the Hermes database, and will not access directly the 
associated object (created only for Hermes specific purposes). 

The plugins for InDesign and InCopy have to handle these object types 
accordingly. InDesign needs to query the database for objects of type 
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INDD_pbj for opening pages, and for objects of type INCD_obj for 
paginating InCopy documents. 



3.2. Texts 



3.2.1. Database requirements 

InCopy documents are stored in Hermes as graphical objects, identified by a 
new object type (e.g. INCD_pbj): the database entry (as for any graphical 
object) will have a link to the JPG preview and the native INCD file. When 
an InCopy document is paginated in an InDesign logical page, the link 
information has to be stored and accessible in the database. Objects of type 
INCD_obj should not be visible or accessible from NewsRoom. 

The following diagram summarizes the database items and their relationships. 



InDesign Logical page 



InDesign object 



InDesign file(s) 




InDesign 

logical 

page 



INDD__obj 



INDD 
EPS 

JPG (PDF?* 




INCD.obj 



INCD 

JPG 

(PDF?) 



Hermes database ■ 



InCopy object(s) 



InCopy file(s) 



UPS Explorer should provide functionality to open both object types (INDD, 
INCD) in the corresponding application. 

3.3. Importing NewsRoom texts 

Using the "Hermes palette" described above, it will be possible to import texts 
created with NewsRoom in InCopy. 

There are several options available in order to transfer textual content from 
NewsRoom to InCopy: 

■ Transfer texts as raw ASCII files, removing all the formatting applied : 
this option will not be acceptable in most of the cases; 

■ Transfer texts converting NewsRoom typographical commands to 
InDesign markup language: although technically feasible (InDesign markup 
language is apparently very similar to the one of NewsRoom) this would 
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require a huge effort; probably the translation should be limited to the most 
nnportant and frequently used commands (e.g. <CF>, <CP> Sc V 
Transfer texts converting NewsRoom tags to InDe^gn^le? 'tins is 
probably the easiest solution, but it is also q\nte effective Ss conviSon 
does not require any interpretation of the tag definition, but simply Sudes 
tag names ,n the exported text, following the syntax required bTK ^? n 

styles will be applied to tagged text. As an enhancement of that, it is possible 
to consider a mappmg mechanism, to allow a customisable mapping of 
NewsRoom tags to InDesign styles: the definition of the mappSg wiS be 
saved to be re-apphed during the import process gwiuoe 
Transfer texts converting NewsRoom tags to XML tags: this is the most 
generic : solution, and should be taken into account with the new XM1. 
available in InDesian/InCoDv Rel ->n a^.\TYi~ , JW1L support 

r«,.„«, TVT ? y °- A S a,n > this conversion does not 

require any interpretation of the tag definition: texts are exported with 
NewsRoom tags converted to XML tags (some elaboration ofmetagorder 
X ^ b " equu ;f d tooh ^ well-formed XML documents). InDesi^and 
InCopy have the capability of importing XML files, and to automatically 
associate styles to tags (mapping has to be pre-defined): the enSf will be 

ISSTlf ? ^ &e Pr ^ OUS POmt « but *• P ro «i will be more 
generic. It is important to point out that the XML representation of Hermes 
objects available n Rel. 6.0 is far too complex for WDesign/tnaUs noT 
exnfc^ SrS* ? h d ° CUment StrUCture: A-S^ £l 

3.3.1. Preserving text features 

3.3.1 .1 . Revision tracking 

S5Lj^T lem ^ te * e conce P t of revision tracking with the 
trSS in f^ 6 " ^ fCatUre is Very close to NewsRoom revision 
stoSL ^SJ?" ™ P °^ ng t6XtS Created NewsRoom, it 
fte Adobe forma? 6 * T ^ * * 

3.3.1.2. Notice Mode- 
^ST^ ^ff^ 20 dement the concept of Notice Mode 

SALES' TfT fCatUre is ^ to NewsRoom 

m f ™}> when importing texts created with NewsRoom, 
it should be possible to maintain all the portions in notice mode bv 
converting them to the Adobe format. °ncemoae,oy 

3.3.1.3. NewsRoom Versions 

Not surprisingly . there is no equivalent in InCopy or InDesign of the 
NewsRoom «pabil,ty of managing different veXons of the^ame 
story: the history of all the versions will be maintained, in Hermes 
storing multiple copies of the same object in the database. 

3.3.1.4. Tables 

InDesign and InCopy 2.0 include powerful options for creating 

Sffi^X? 'T 163 "* * - * Newborn 

(e.g. Merge/Split cells, rotate text, cell border and fill), but Adobe 

US, S-^f* ** to 0peaT ™ e supportand advanced 
import capabdines. Anyway, it should be possible to import table 
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content created using NewsRoom from the Hermes database into 
InDesign/InCopy, with the same approach presented above for texts. 



3.4. Importing graphical content 

Using the Hermes palette, it should be possible to import graphics from Hermes in 
InDesign: the operation will be a link to a graphic container, equivalent to InDesign 
"File/Place" menu command. InCopy does not have any capability for managing 
graphic objects. * * t,J 

The import process will follow the rules and - eventually - the restrictions set by 
InDesign: in Hermes, graphic objects can be saved in the database using Photoshop 
plugin, NewsCrop application of Hermlmport server tool. In any case, the high- 
resolution file is stored in the associated filesystem, together with a low-res and a 
medium-res version of the graphic: all the image formats supported by Hermes 
(JPEG, TIFF) are supported by InDesign as well. 

InDesign also supports EPS and DCS files, and OPI links eventually included: there 
is also a useful pre-flight function that could be invoked when generating the EPS 
version of a page. 

In particular, when importing EPS files, several import options are available in 
InDesign: 

■ Read Embedded OPI Image Links 

■ Apply Photoshop Clipping Path 

■ Proxy Generation 



3.5. Photoshop images 

Currently Photoshop is integrated with Hermes, with a set of plugins enabling the 
application to save and retrieve images from the database: this set of functionalities 
has to be maintained and supported in the new integration scenario. 



3.6. Illustrator objects, PDF files 

InDesign natively supports both Illustrator and PDF documents, with several options 
available when importing them. This native support will always be available as a 
possible way for supporting these formats, but it is necessary to evaluate the 
possibility of storing these objects in the Hermes database, and to paginate them in 
InDesign from there. This implies creating new Hermes object types (e.g. Illustrator 
object, PDF object), and therefore will increase the complexity of the integration: 
however, there will be evident tremendous benefits for being capable of supporting 
the Adobe suite in Hermes. 

It is not strictly necessary to integrate all the applications with dedicated plugins: for 
tools used less frequently, a server-based import process (e.g. evolution of 
Hermlmport), watching several folders waiting for files to be processed may be an 
acceptable solution. This approach may eventually adopt Adobe AlterCast to convert 
or generate different versions of incoming files (e.g. to generate an EPS file from a .ai 
file). 



Internal Use Only 



16 



4. Hermes configuration 

Object types: two new object types need to be introduced 

Levels: no changes, but it will be required that levels devoted to contain InDesign 
Logical pages will be allowed to contain objects as well. This to store both the page 
and the required object in the same place, in order to simplify the entire process. 

Permissions: the following items need to be updated in order to manage two new 
object types: Access tree classes, to set permissions on objects in specific levels 
(create, read, write, etc.); Access Object Classes, to set the initial status for new 
objects. 

Statuses: it appears there is not a specific need for changing statuses management. 
Both object and logical page statuses have enough options to cover the needs of 
InDesign / InCopy objects. As an example, the attribute "All objects ready" available 
for logical pages could be used to trigger the generation of EPS and the lock of all the 
content in a page. 

Functional permissions: it is possible to envisage a set of permissions for InDesign 
and InCopy, to further customize user profiles by inhibiting or not program 
functionalities. They will be associated to workstations/permissions groups as it is 
today with Hermes client applications. 



5. What's left 

Although this integration has been thought through from a marketing perspective, 
there are still technical evaluations to be done. In detail, they are 

• Hermes Web Agent: It is required to verify, if the functionality required by 
this integration is available or need to be developed 

• OPI: Technical evaluation, whether the UNISYS OPI process can handle all 
possible PS output from InDesign 

• Import and Export procedures 

• Adlnterface 

• Maintenance 
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1 Scope 

1.1 System Overview 

The purpose of this project is the integration of third parties applications with 
the Hermes editorial system. Third party applications are required to support an 
advanced query mechanisms that behaves like the Unisys Hermes Explorer 
application. 



1.2 Document Overview 

This document describes how the Integration Platform will implement the 
required services to allow third party applications to perform queries in an 
extended way, thus allowing users of Hermes client and external applications to 
have the same capabilities on bom sides. 

2 Referenced documents 
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3 System design decisions 

* 

External applications that are integrated within Hermes produce different types 
of content according to their capabilities. 

The different contents produced are standardized to pages and object inside 
Hermes By taking into consideration the standardization, Hermes will 
automatically handle queries on both internal and external pages 
In designing this feature, we will consider the current system architecture to 
obtain maximum performances and to create a powerful query SOAP engine 
that makes maximum use of the capabilities offered by Hermes. Since the 
imp ementation of the Hermes query is powerful enough to support this 
unplementation, the query via SOAP will be a wrapper around the Hermes 

3.1 High level system behavior 

The query in Hermes can be divided into object query and page query 

AU the search parameters available in Hermes will be available also to the 

SOAP integration platform. 

3.1 .1 Description of advanced query 

Advanced query allow third party applications or, in general SOAP aware 
client app ications, to search for objects and pages by specifying different 
All the search parameters are handled by placing an operator AND 
among all the values. 

The query created on the client application is then built as a SOAP request that 
is sent for processing to the SOAP application server, which executes the query 
and returns a resultset as a SOAP response. ' 
Since Hermes is capable of storing thousand of objects and pages, a particular 
interest is placed on the performances of the query via SOAP. 

Protocol restrictions to performances 

Query executed via SOAP might be slower than query executed in the native 
Hermes environment because of the different protocols used. In the Hermes 
environment, a proprietary transport protocol over TCP is used and the protocol 
has been designed to be fast by reducing at minimum the verbosity of the 
transmission. J 

■ The HTTP protocol, instead, is designed to be a general purpose transport layer 
to move myriad of data format over the internet. To allow this, the HTTP is a 
verbose protocol with a lot of decorations of each packet 
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When files are attached to the message, the SOAP technology moves oacket in 

toe SOAP technology relies on XML, which uses a lot of "space" toS 
r^H ?' DUC t0 S" 6 conside ^ons, each XML exchange shoutTbe 
reduced at minimum. For example, avoiding carriage returns in L rehouse 

X^TvtoS t l Ae Si2C ° f Packet b * keeping the vafi 

XML payload. A simple carnage return is not significant itself but in the mierv 

response context which could be very huge, it mates the difference 

Because of the HTTP design, the imputation olthe que^t prevent the 

connection from being too long. For achieving this goal and c SdS£ £e 

^beTeS^ 

number is determined by taking a complex query result JSnnlder^TZ 

J^ST^J^ server^nt^SOA? 
SwI 7 u for ^ ^Plementation, it is recommended to pre- 

sS^r ^ ^ String 8126 * ° rder to «** -allocations^ 
SL^"? ^ ori ^ to 'esize the string which doubles the size each time a 
2" eed f t0 be resized - ?y serving a good amount of bytes on the strinTme 
number of reallocation decreases dramatically and the speed for the XML 
string construction to be sent to the client will increase exponential^. 

External objects 

To support the external objects searches, the SOAP request must contain a ta E 

Tw^T W ~ Ch ^ ° f ° bject to search for - However, the ty^ToTobjel 
different from Hermes types, cannot be determined "a prior?* sinJe me 
bitegration Platform allows every application to be integ^ted Tthout 
^1 S g u n thB HenneS Software ' a SOAP ™thod to query *e "cu^entiy 

r^ST '• l aV< ? d u f ^ Cy ° bject ^ «** ^ will be registered in 
t ^^ reglS 7 ° f tyP^ by using a descriptive string and fce MIME 
fh e ?n^P? P Ca «° n * at f that particular type of object. 

The SOAP Integration Platform query service will then use tie MIME tvne to 

StsoTa ! ZHfrSFl ^ dient aPPliCati ° n use ^ dlscri^ve^alue 
to display a user-friendly choice to the user. 
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4 Performance 

Particular focus must be kept on the optimization. A prototype implementation 
has proven that with simple contrivances the performances of the query (both 
receiving and responding) will lead to an overall performance that is almost 
equal to the Hermes implementation. 

4.1 Speed 

No degradation in speed due to the implementation of the system. 

4.2 Reliability, availability and 
maintainability 

No degradation in reliability, availability and maintainability due to the 
implementation of the system. 



4.3 Capacity 

No degradation in capacity due to the implementation of the system. 
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SOAP Integ ration Platform 

1 Introduction 

This document is the detailed design specification of the SOAP Integrate 

to * e design phase of 4116 "ESSES 

2 References 

The following table shows the references to the standards used during the 
Table 1 Referenced standards 



J Description 




Specification 
version 1.3 

OpenSSL 
specification 
and downloads 

Multipart 


httD://w3.o^/sn;,p 


httD.V/www.openssl nrp; " 


messages 


htto://w3.orft " — — 


IANA official 
registered 
mime types 


http://www.iana.orp~^^~"~ ~~ " ■ J 


OPI 1.3 
specification 


http7/partners.adobe.com/asn/developer/pdfe/tn/OPL1 3.pdf " 


opi 2.<r 

Specification 


ntt P'''Partners.adobe.<x>m/asn^ 


Adobe XMP 
technology ^ 
specification 

The Unified 


http://partners.adobe.com/ ~ — 

* j 

httDl/AAAWW rattnnal mm "~ — — ' ■ J 



Modeling 
Language 
specification 
version 2.0 
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Reader should also refer to the following Unisys documents 
Table 2 Unisys referenced documents 



Description 


Reference 


HE70-DS-SAS 


SOAP Application Server Design 
Specification 


HE70-FS-AQTPA 


Advanced Query in Third Party 
Applications via SOAP Integration Platform 


iPlatModel..mdl (temporary 
name) 


SOAP Integration Platform Rose Model 


HE70-MS-AINCM.doc 


Vision document - Solution Management 
requirement for third party application 


HE70-DS-AIES.doc 


Adobe Integration with eEditorial Solutions 
Design Specification 



Z Definitions, acronyms and 
abbreviations 

; 

Table 3 Definition, acronyms and their references 



| ACRONYM 


DEFINITION 


REFERENCE 


SOAP 


Simple Object Access 
Protocol 


htto://w3.orff/SOAP 


XML 


Extensible Markup 
Language 


httn://w3 .ore/XML 


HTTP 


Hyper Text Transmission 
Protocol . 


htto://w3 .ore/Protocols 


HTTP-S 


Hyper Text Transmission 
Protocol - with data 
encryption 


httD://w3 .ore/Protocols 


IFRA 


largest international 
exhibition dedicated to 
newspaper and media 
technology 


httD://www.ifta_com 


Hermes Agent 


An HTTP bridge to the 
Hennes system 




CMMI 


Capability Maturity Model 
Integrated 


http://www.sei.cmu.edu/cmmi/ 


DOM 


Document Object Model 


Standard for XML navigation, 
parsing and construction 
httD://w3.orff/XA/TT 
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4 System Overview 

The SOAP Integration platform is a framework built on top of the existing 
Hermes editorial system. The purpose of this software layer is to make a 
large set of Hermes API available to system integrators, in order to produce 
content with different software that can take advantage of the Hermes 
editorial production system. 

The design of the system relies on standard protocol for the communication 
and on SOAP as the lightweight protocol to enable interaction with the 
outside world. 

Particular interest must be reserved to extensibility and modularity, in order 
to minimize the impacts on other components when adding functionalities. 
The system will be separated into two logical components: 

• Core Service, responsible for managing the run-time mapping from 
SOAP calls to WEB services and vice versa 

• WEB Services, responsible of wrapping Hermes calls in a transparent 
way to the Core Service layer. Each request dispatched from the Core 
Service is rolled out by each specific WEB service. 

The entire architecture includes a new Hermes module responsible of 
managing HTTP connections/request 

5 Architecturally Significant Design 
Packages 

An overall component diagram of the system is shown below: 
Figure 1 SOAP Integration Platform overview 



SOAP 
Appliqati... 




Hermes SOAP 
Services 
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6 Design Consideration 

Most of the code used to write Hermes is C/C++ code and, although the 
core has a well-defined set of APIs, it does not allow direct interaction with 
applications different from the clients that are part of the system. 
Furthermore, Hermes uses a proprietary communication protocol that is 
difficult to "externalize", because it requires that a set of specific libraries 
on server and on the client must be available. 

This requires that the client must be equipped with a software package that 
prevents it from being completely independent from the implementation of 
the server side. 

The design of this framework will focus primarily on extensibility and 
modularity: 

• Extensibility: by separating the core service module from the actual 
implementation of wrappers around Hermes API, the extensibility is 
achieved, since is implicit the ability of adding new services. 

• Modularity: in order to achieve the maximum level of extensibility of 
the framework, the core service layer must be separated from the actual 
Hermes wrapper implementation and specific services will be provided 
by small components plugged to the framework. 

The design of a SOAP Platform that lies on top of Hermes is possible 
without a great effort because of the similarity of the network protocol used 
by Hermes with the HTTP concept. In fact, although they are different in 
constitution, both rely on the request response strategy to implement 
communication between client and server. 



6.1 XML Parser 



XML is managed through the use of the Xerces library, which offers a C++ 
implementation of the DOM conform to the W3C specification. 
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7 Architectural Goals and 
Dependencies 

The SOAP Integration Platform will be designed to exploit the existing 
Hermes implementation, allowing the Hermes system to interface with any 
other external application. The WEB services will implement services by 
calling and arranging the existing Hermes APIs. Specific assumption and 
dependencies are: 

• There will be no new development inside Hermes to adjust gaps 
between SOAP and the core. Instead, the design assumes as a fixed 
point the existence of Hermes. 

• A new module will be implemented as the endpoint server for two 
reasons: 

> The existing hermesagent cannot be overloaded since it is used 
for the HermesWeb product and no modification to the 
performances is possible. 

> The Integration Platform is a product that Unisys will deliver 
under license and not as an add-on to an existing licensed 
product. 

• No direct database operation will be performed. Each access to the 
Hermes storage will rely on the existing Hermes APIs, in order to 
leverage the current capabilities. 
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8 Constraint 

As mentioned before, Hermes is a proprietary system built with C/C++ 
language. Java should be the natural way of building a SOAP extensible 
layer but the gap between the two languages is difficult to be managed and, 
when managed, it relies on a difficult to understand mechanism that cannot 
be easily reproduced. 

8.1 Hardware constraint and 
requirements 

The SOAP integration platform will be available for both Intel and SPARC 
processor. 

8.2 Software constraint and 
requirements 

For the software environment: 

- Windows 2000 Advanced Server 

- SUN Solaris 5.8, 32 bit version 

Both platforms will be available according to the Unisys certified standards. 
The implementation of the code must take into consideration of the 
architectural differences among platforms. 



8.3 Performances 

The design of the framework will take into high consideration the 
performance issue and no degradation or limitation to the existing Hermes 
system will be caused by the framework itself , 
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8.4 Network Communication 

Network communication between the Integration Platform and the various 
actors will rely on standard HTTP / HTTPS transport over TCP/IP protocol. 
The communication mechanism used inside Hermes is request-response 
based. Client applications post a request to the server and wait for the 
response from the server which does all the processing, requirement The 
same concept is applied to the HTTP, with the main difference in the 
"purpose" of the protocol. The Hennes proprietary is tailored for the 
specific application needs, while the HTTP is a multi-purpose generic 
protocol. 

This means that performances are quite different, since the HTTP needs a 
lot of extra meta-information to describe the data it is carrying over the 
network. Due to this verbosity, a particular attention is paid in the 
optimization of long responses from the SOAP server. 
The SOAP integration platform provides communications in both plain 
HTTP and over Secure Socket Layer by using the OpenSSL library. The 
secure framework implementation is, however, responsibility of the SOAP 
application server, which design is detailed in document HE70-DS-SAS. 



8.5 Verification and validation 



The entire platform will be tested with specific procedures to ensure that: 

• Multiple concurrent SOAP messages can be delivered to the services 

• Buffer overflow protection is conectly implemented 

• Invalid XML packets are correctly handled without problems to the 
SOAP core 

• Malformed HTTP requests are handled correctly without problems to 
the SOAP core 

Each developed service will be placed under regression test to ensure that 
no alterations to the SOAP core service layer have been made. 
The alpha tests will be made by using scripts to send XML calls to the 
framework. The scripts will be refined on use and delivered to the testing 
group as an add-on to help integrity test. 
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9 System Logical View 

In order to depict a logical view for the system, a typical usage scenario is 
shown below. 

10 Subsystem design. 

10.1 SOAP Application Server. 

The SOAP application server is described in document HE70-DS-SAS 

10.2 SOAP Service layer 

The SOAP Service Framework is responsible of the management of the 
SOAP requests received by the SAS. The SAS checks the HTTP header for 
validity of session id and SOAPAction values. If these values cannot be 
verified, the request is not handled and an error is returned to the caller in 
the form of a SOAP fault 

If the HTTP header is valid, the SAS calls the SOAPService Registry and 
passes the SOAP request. The SOAP sendee registry looks for the service 
handler (WEB Service) that implements the method requested via SOAP 
and, if a service is found, it dispatches the SOAP call to the specific WEB 
service for being processed. The SOAP core will offer a set of methods to 
the WEB services, thus allowing to: 

• Get parameters from the SOAP call 

• Get the value of the parameters appropriately converted to C/C++ type 

• Create the SOAP response to the call and abstract any specific XML 
construction and handling 



10.2.1 Service Registry 

The service registry lies in the SOAP core and is responsible of maintaining 
the list of service and the mapping between SOAP methods and services 
that implement them. In order to keep a high level of extensibility, the 
services are mapped to specific calls via an XML file (deployment file) that 
is read during the server start up. 

Doing so, enabling or disabling specific services will simply imply 
removing the mapping inside the deployment descriptor. 
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Furthermore, a particular protection level is placed into the service registry 
to allow continuing to offer services also if one or more services are deleted 
from the file system. The service registry is implemented as a singleton 
object using the Singleton pattern, in order to give the caller a single point 
of access to the WEB Service instantiation point. 

The service registry singleton should be implemented with a double- 
checked locking pattern (Schmidt,l 2001 145) . Although the service core 
itself does not dispatch services into different threads because it relies on 
the multithread SAS engine, this rule could become invalid for performance 
reasons. By definition, the singleton exists in a single instance. The 
constructor of this type of object, however, cannot have a locking 
mechanism because of the following race condition: & 



Figure 2- Multithread unsafe singleton instantiation 



Thread A 



TimeB 




Thread B 



Both threads find the 
instance equal to NULL and 
try to create the singleton 



Thread A ThreadB 

Check the static pointer 

No static pointer is available Check the pointer 

Lock No pointer available 
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When the thread A is in the LOCK condition is about to create the static 
pointer. When the thread B comes into, no instance is available and 
proceeds to its creation. To prevent this, the double-checked locking pattern 
[2] tests for the instance of the object and, if it does not exist, the object is 
locked. After the lock is acquired, the thread tests again the instance to see 
if in the meantime another thread created it. The maximum level of safety is 
achieved because the second thread waits until the mutex is available and, 
when this condition is true, the thread finds the instance already created and 
returns the pointer to the instance itself 



« Concurrent access to the singleton - Drawing Placeholder» 



Figure 3 Thread safe singleton instantiation 



After the Service registry has determined the method that is being called by 
parsing the SOAP request, it returns a pointer to the WEB service entry 
point in order to dispatch the work. 

By using the double-checked locking pattern, the atomicity of the change to 
a singleton object is guaranteed even in multi CPU environment. In a single 
CPU environment, in fact, threads are "interleaved" and concurrency occurs 
less frequently than in multithreaded applications running on different 
CPUs. 

The service registry is as an object factory and should be implemented as in 
[4] to decrease the interdependency between implementation of the core 
and implementation of the services and to speed up the SOAP dispatching. 



10.2.2 Service entry point 

In order to decrease the dependency between the core and the modules, the 
SOAP integration platform uses a deployment descriptor to map the service 
implementation to a service entry point. Whenever a request comes into, the 
service registry looks up the SOAP method into the XML payload and 
searches for a suitable implementation. If an implementation is found, its 
entry point is called to instantiate the actual service implementation. 

C++ language does not allow a class to be created using its name as 
parameter, for example, to the constructor. A code such as 

const char *className = "Specif icClass" ; 
BasePointer *instanceOfTheClass = new className; 
Is not valid. 
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The solution of such a problem, which enables the ability of mapping 
service to method in an external file, is to use the inheritance to make all 
the service implementation specialization of a base class. Each 
implementation method inside the WEB service, has a C entry point whose 
name is actually mapped to the service via the deployment The service 
registry reads this entry point from the deployment descriptor, loads the 
WEB service dynamically and gets the address of the creator function 
(entry point). Once this has been done, the service registry calls the entry 
point of the WEB service that does nothing but creating a new "class" and 
returning a pointer to it 

Implementation class 
class SOAPImplementation : public SOAPServiceHandler 
The entry point will be 

SOAPServiceHandler *EntryPoint Function ( ) 



This is the only way to bypass the previously mentioned C++ limitation. By 
using this technique, each SOAP call can be added to the entire framework 
without recompilation of the layer. 

The collaboration diagram for the service lookup and dispatching is 
reported in Figure 4 

Figure 4 Service instantiation and dispatching 
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return new SOAPImplementation; 



} 
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The service registry maintains a mapping between the service name 
exported and the module that implements the function. This mapping is 
loaded at the service registry instantiation by reading the deployment 
descriptor from the file system. The deployment descriptor is an XML file 
that maps the name of the entry point inside the service and the dynamic 
hbrary with the implementation. Since this mapping does not change during 
the service registry run time, it should be optimized for fast searches rather 
than tor fast insertion. A suggestion for obtaining fast searches is to use the 
standard library vector instead of a map. As discussed in [3] using a sorted 
vector of elements is significantly faster than using a map of keyed value 
since the map is implemented as a RB-tree with overhead that is optimized 
for fast insertion. 

Once the service has been found and instantiated, the SOAP core finishes to 
parse the XML and loads the parameter map. 



10.2.3 Parameters Map 

The SOAP core manages two types of parameters: 

Simple parameters 

Complex parameters (structure) 

Simple parameters are used to map directly name-value pair, while complex 
parameters can contain simple parameters. This allows the SOAP 
framework to manage a large variety of parameters combination. In fact bv 
using a Composite Citations 

[1] pattern, it is possible to manage parameter that can be composed of a 
structure and each element of the structure is composed by other structures 
To create the correct parameter object, which depends on the XML 
structure of the SOAP request, a class factory Citations 

[1] is used to delegate the construction of the appropriate object. The 
collaboration among object is represented by the following diagram: 
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Figure S Collaboration diagram for parameter creation 
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The parameter map should be implemented for fast retrieval rather than for 
fast insertion, thus the suggestion becomes the same as per the service 
mapping discussed in chapter 10.2.1 



10.2.4 Attachments parameters 

The integration platform allows creation of content with third party 
applications and such a content is "converted" to Hermes objects and pages. 
SOAP incoming messages must have the ability to attach files. To allow the 
mixed XML and binary content in a SOAP message, a multipart - mime 
message is used. The SOAP core is responsible for the parsing of the 
multipart message and the storage of the raw bytes of the attachments. 
Details of messages with attachments are provided in the HE70-DS-AIES 
document, where the interface between the system and client applications is 
fiilly described. 
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10.3 Hermes Web Services 

Hermes Web Services are components that are plugged into the SOAP 
Integration Platform to .perform the real request processing. These modules 
are implemented as dynamic link libraries that are loaded on demand and 
stay active during all the run time. 

Hermes Web Services have the responsibility to wrap Hennes legacy code 
into object-oriented components that are instantiated by the platform. The 
effect on the Hennes code is null and the implementation can leverage the 
existing API, thus minimizing the effort to make Hermes an open system. 
The services should be divided into "categories'* depending on the task they 
run. A special category is that including services responsible of critical 
task, where this tasks cannot be unplugged from the platform since they are 
vital for the existence of the platform. In this category, die following 
services will be placed: 

Login service 

Logout service 

Session management service 



These types of services cannot be mapped into the deployment descriptor, 

thus they cannot be unplugged from the platform. 

Hennes specific services are divided into the following categories: 



Service category 


Hermes specific task 


Objects 


Hennes object management, such as creation, deletion, 
retrieval of objects. 


Pages 


Hennes page management, such as creation, deletion, 
retrieval of pages, link/unlink of objects to/from pages 


Edition 


Edition management, such as edition listing, zone 
management 


Workflow 


Object and page status management 


Users 


User management, such as user data retrieval, permission 
checking 


Level 


Level management, such as level browsing 



10.3.1 Module caching 

The SOAP core manages the various WEB services by keeping a table of 
method/service implementation. Each time a method is run, the table is 
updated by incrementing the usage count for the module and decrementing 
each module that has not been hit When the counter for a module is equal 
to 0 (zero), the module is discarded thus gaining memory and, 
consequently, performances. 
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10.4 WSDL 



Each implementation module should be able to describe itself and the 
parameters name/types, as well as the return values. This enables the SOAP 
core to implement a system service that collects the information about the 
services. By doing this, a discovery tool can be created to give a "generic 
client" a way to obtain information about what Hermes SOAP is offering in 
term of WEB services. 



10.5 SOAP response 

The responsibility for creating response is equally divided between the 
service handler (implementation of service) and service dispatcher. The 
service dispatcher offers a response object to the called implementation 
that, in turn, fills in the return value elements that compose the response. 
The service dispatcher creates an XML SOAP response by attaching the 
response built by the service implementation to the SOAP envelope. The 
service dispatcher is responsible to create the correct XML response and to 
verify that it is conformant to the SOAP specification. 



HE70-DS-SIP 



19 



SOAP Integration Platform 



Unisys 



1 1 Metadata management for Adobe 
Applications 

Metadata will be handled whenever possible using the XMP technology. 
XMP is an Adobe proprietary technology platform for metadata embedding 
inside data file. The XMP usage has different advantages, such as: 

• Free of charge and OpenSource: this allow the developer to work with 
the source code which is extremely important to understand the working 
internals and for the debugging of application 

• Cross platform. The XMP SDK is delivered and tested on different 
platforms, such as UNIX and Windows. This enables the complete 
reuse of the core code 

• Metadata are embedded into asset files using XML, Dublin Core 
specification. 

Metadata can be embedded in IhDesign/InCopy file directly from the 
application and extracted on the server, thus allowing the storage in a 
database that offers query functionalities. 

XMP must not be used to embed metadata in image file. In fact, the JPEG 
specification for example, implies that a reader application or image 
manipulation software discards every non JPEG data inside the file. 
Opening a JPEG with XMP embedded metadata with software different 
from Adobe will result in removing the metadata. 

12 Evolution 

The architecture of the SOAP integration platform and the implementation 
based on legacy code wrapper, enables a high level of extensibility. After a 
first major release of the integration platform, new services will be added to 
perform even News Gathering Manager operations. 

From the platform perspective, an interface for service management will be 
created, allowing the service startup and shutdown from remote client 
applications, such as an administration WEB page. 

This design and architecture team will consider also a model for inter- 
service communication, to allow the reuse of code and implementation 
among services. 
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1 References 



This functional specification refers to Pages and Objects Management in External 
Applications Editorial Enhancement EE-2002-03. 

Refer also to the following documents: 

• HE70-FS-TPIN functional specification for details on Third Parties Integration 
with NewsRoom 

• HE70-FS-TPIHE functional specification for information about Third Parties 
Integration with Hermes Explorer. 



2 Functional Overview 

The functions described in this document aim at providing a general overview of how 
pages and objects created with third party applications will be managed in order to 
integrate them with the Hermes workflow. This is to make third party applications part 
of the suite of Hermes tools, allowing them to access content stored in the database, 
save pages and stories in the database, support workflows, user permissions and 
profiles. 



2.1 Major functions 

• Creation of logical pages using third parties applications, so that they can be 
integrated with the UPS editorial system. 

• Save/Release of pages created with third parties applications in the Hermes 
database according to the UPS editorial workflow. Once stored in the database, it 
will be possible to take actions such as loading the page, deleting it, or use it for 
interacting with Hermes client applications such as UPS-Explorer and NewsRoom. 

• Creation of objects using third parties applications, in order to save/release them to 
the Hermes database, so that they can be used both from UPS applications and 
third party applications (for example Adobe InDesign). Once stored, they can be 
searched through a specific query, loaded for further editing (into the native 
application only), deleted, and so on. 

• Pagination (link) of objects (either created by third party application or by UPS 
applications) into external pages. 

• Unlink of objects from pages. 
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2.2 Data/Activity Diagram 

Not applicable. 

2.3 Assumptions and Dependencies 

The figures (if any) depicted in this document are dummy screenshots only. 

2.4 Migration, Compatibility and Co-existence 

This functionality will be implemented as part of the overall Unisys Publishing 
Solutions environment. • 
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3 Functional Description 



In order to support the integration of third party applications with the suite of Hermes 
tools, the client application will be provided with the capability to create logical pages 
in Hermes. Pages created with this tool will be different from those created with 
Newsroom and will be modified in their original format by the external application 
only. Other third party tools (for example Photoshop, Illustrator and InCopy, in case of 
Adobe applications) will be used for the creation of objects to be inserted in these 
pages. It will be possible to create a page first, then assign the various text containers to 
different users that will open the object thy are assigned to and will write to fit. In this 
way, multiple users will be able to work on different objects contents present on the 
same page, while the page layout can be modified by a single user only. Pages and 
objects will be modified with the tools used for their creation. 

Some of the functions described in this document will also be accessible through a tool 
palette that will be available in the external applications to permit the interaction 
between the client application and Hermes. The functions covered by this palette will 
be detailed in a dedicated document. 



3.1 Managing pages with third party applications 



3.1.1 Description 

External documents (for example, pages coming from tools such as Adobe InDesign) 
will be stored in Hermes as logical pages. The corresponding database entry will have a 
link to the EPS file generated by the third party application, the JPG preview and the 
native external file. 

Each external document will be a logical page that will be created when saving the 
document to Hermes. Once in the Hermes database, external logical pages will be 
available for interaction with Hermes client applications, such as UPS-Explorer or 
NewsRoom. The interaction between external pages and the Hermes applications 
above-mentioned will be dealt with in dedicated documents (refer to the HE70-FS- 
TPIHE and HE70-FS-TPIN respectively). Any change to the original external page will 
be performed in the native application only. 

The following functions will be provided for page handling using the client 
application: "~ 

• Create page. This function will allow users to create a new external page based on 
the available page grids (according to the chosen level). The application will 
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display a dialog window requiring users to enter the page level. The system will 

then display a list of available editions according to the chosen level. If the selected 

level requires a publication date, the system will ask the user to enter it In addition, 

users will have to provide a name for the page being created. 

This action will result in the creation of a new record for a logical page in the UPS 

database and the locking of this record. An initial status will be set for the created 

page. 

• Save Page. This function will allow saving the external page by displaying a dialog 
window where users can specify Level, Edition, Page name and publication date (if 
required by the selected level). The save operation will update the external record 
in the database. The process of saving pages requires the native external document 
to be sent by the client application. 

Each time a save operation is performed, the client application will attach a 
preview in order to let Hermes display a preview in all other client applications. 

• Release Page. To release the external page, users will select the appropriate status 
the page will be moved to according to the e-Editorial workflow from the dialog 
window that will be displayed when the Release function is selected. The Release 
dialog window will list the entries corresponding to the statuses along with a small 
square filled in with the color representing the status (as currently available in UPS 
client applications). The Release action will update the logical page record and the 
logical page will be unlocked. As for the save operation, the native external 
document will be sent by the client application. In addition, the client application is 
responsible for creating and attaching the relevant preview document if required by 
the workflow. If the page contains links to images files that come from the Hermes 
system, OPI comments will be placed in the EPS to reference the path of the high- 
resolution version of the image. 

• Load page. When loading an external page from the database the page will be 
open in its native application. Users will then be able to modify the page according 
to their needs using the tools provided by the originating application. Usually, the 
load operation is performed after executing a query. Opening pages will also be 
possible through the Hermes tool palette which will be available into third party 
applications, 

• Delete page. Page deletion will be allowed via a push-button, as well as via menu 
item. If the page is locked, the operation will fail. If the operation succeeds, the 
database will be immediately updated. Deleting pages will also be possible through 
the Hermes tool palette which will be available into client applications. 
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3.2 Managing objects with third party 
applications 

3.2.1 Description 

As for pages, it will be possible to create objects (texts or image type objects) with 
third parties applications and store them into the Hermes database. The corresponding 
database entry will have a link to the JPG/EPS preview and the native external file. 
When an InCopy object is paginated in an InDesign logical page, the information 
relevant to the link will be stored in the database. When these objects are loaded in 
order to be modified, they will be opened in their native application. 
UPSExplorer will allow to open objects coming from both Newsroom and InCopy 
applications in the corresponding application. 

In order to provide a tight integration between the Hermes system and third party 
applications, the following function will be available: 

• Create object. This function will allow users to create a new object (either a text or 
an image object). The application will display a dialog window requiring users to 
enter the object level. The system will then display a list of available editions 
according to the chosen level. If the selected level requires a publication date, the 
system will ask the user to enter it. In addition, users will have to provide a name 
for the object being created. 

This action will result in the creation of a new record for an object in the UPS 
database and the locking of this record. An initial status will be set for the created 
object 

• Save Object. This function will allow saving the third party object by displaying a 
dialog window where users can specify Level, Edition, Object name and 
publication date (if required by the selected level). The save operation will update 
the record in the database. The process of saving pages requires the native textual 
document to be sent by the client application. Each time a save operation is 
performed, the third party application will attach a JPEG preview in order to let 
Hermes display a preview in all other client applications. 

• Release Object To release the external object (or other third party object), users 
will select the appropriate status the object will move to according to the e- 
Editorial workflow from the dialog window that will be displayed when the 
Release function is selected. The Release dialog window will list the entries 
corresponding to the statuses along with a small square filled in with the color 
representing the status (as currently available in UPS client applications). The 
Release action will update the object record and the object will be unlocked. As for 
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the save operation, the native external document will be sent by the client 
application. 

• Load Object. When loading an external object from the database (or an object 
created with another third party application) the object will be open in its native 
application. Users will then be able to modify the object according to their needs 
using the tools provided by the originating application. Usually, the load operation 
is performed after executing a query. Opening objects will also be possible through 
the Hermes tool palette which will be available into third party applications. 

• Delete Object. Object deletion will be allowed via a push-button, as well as via 
menu item. If the object is locked, the operation will fail. If the operation is 
successful, the database will be immediately updated. Deleting objects will also be 
possible through the Hermes tool palette which will be available into third party 
applications. 

• Link object to page. It will be possible to paginate objects in InDesign pages 
either via menu item or, after executing a query, from the query results. The 
selected object will be paginated, provided that it is not already linked to another 
page. If this is the case, a warning message will be displayed and the link operation 
will fail. 

Files from the file-system will be placed into InDesign documents only after they 
have been inserted into the Hermes database. If a local file is placed, users will be 
asked to create the object in the Hermes database by providing the Level, Edition, 
publication date (if required by the selected level) and name of the object being 
created. If the creation of 1he object fails, no files will be placed into the page. If the 
creation succeeds, the high-resolution is uploaded to Hermes and a Hermes 
generated low-resolution is downloaded for placement using the object ID to link 
the asset to the page. If placed files are image files, appropriate OPI comments will 
be inserted into the EPS to reference the high-resolution path of the image on the 
Hermes file system. Furthermore the EPS will contain the OPI comments for the 
transformations applied to the image. 

If a local text is inserted in page, a new InCopy object will be created and then 
placed in page. 

Linking objects to pages will also be possible through the Hermes tool palette 
which will be available into third party applications. 

• Unlink object from page. Objects can be unlinked from an InDesign page directly 
from the query result or via a menu option. When an object is unlinked from the 
page, it will be removed from the page and the database will be updated 
immediately. This will free the object and make it available for pagination. 
Unlinking objects from pages will also be possible through the Hermes tool palette 
which will be available into third party applications. 

• Versioning. Versioning applies only to objects. It will be possible to keep track of 
different versions of an object Users will ask for an overview of an old version of 
an open object from the client application via menu item. As a result, a list of 
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version numbers will be displayed. The version list will be sorted in a descending 
order, or last-first. The user can select a version and open it in read-only mode. A 
new version of the object will be created whenever the object is released to 
Hermes. 

• Dummy text - Third party application textual objects (for example InCopy 
. objects) found in a status with an attribute different from READY FOR TYPESET 
will be shown as dummy text instead of the actual text, preserving the text styles 
and format. Depending on clients needs, a proper status attribute will be inserted. 
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4 Information for User Manual 

This functional specification, once approved, will be used by the technical writers to 
create the updates for the User Manual, 

5 Performance 

5.1 Speed 

There will not be degradation in speed due to the implementation of this enhancement 

5.2 Reliability, Availability and Maintainability 

There will not be degradation in reliability, availability and/or maintainability due to 
the implementation of this enhancement. 



5.3 Capacity 

There will not be degradation in capacity due to the implementation of this 
enhancement. 



6 Installation 

Not applicable, as this is an enhancement request to an existing product with 
established installation and trouble-shooting procedures. 
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1 References 

This functional specification refers to Hermes Palette Availability in External 
Applications Editorial Enhancement EE-2002-03. 

Further references: 

• HE70-FS-AQTPA for details on the search function in third party applications. 

• HE70-FS-POMEA for details on the page and objects management in external 
applications. 

2 Functional Overview 

Availability of a tool palette in third party applications providing access to content 
stored in the Hermes database, according to the workflow and users permissions. The 
Hermes palette will be a fast and easy way to perform operations on objects and pages 
retrieved from the database directly from the query results list. 

Most of the functions provided by the Hermes palette will also be available via menu 
item and will be described in dedicated documents. 

2.1 Major functions 

The tool palette will provide users with quick access to the following functions: 

• Capability to query the Hermes DB from a third party application in order to search 
for stored pages previously created with the external application. The query can be 
narrowed down by specifying appropriate parameters that will allow to easily 
retrieve the page(s) being searched. 

• Capability to query the Hermes DB from a third party application in order to search 
for stored objects previously created either with the external application, or using 
the Hermes client applications (NewsRoom). The query can be narrowed down by 
specifying appropriate parameters that will allow to easily retrieve the object(s) 
being searched. 

• Capability to open objects/pages by dragging&dropping the retrieved items in the 
application main screen. This capability will also be provided through a menu item, 
or double clicking the item to be paginated. 

• Capability to paginate retrieved objects in pages created with third party 
applications. 

• Capability to unlink objects linked to a page 

• Capability to delete retrieved objects and pages. 

• Import content of NewsRoom textual object into an external textual object. 

• Capability to move objects/pages among levels 
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2.2 Data/Activity Diagram 

Not applicable. 

2.3 Assumptions and Dependencies 

• The figures depicted in this document (if any) are dummy screenshots. 

• The GUI of all new dialog windows/controls implemented must be XP-like style. 

2.4 Migration, Compatibility and Co-existence 

This functionality will be implemented as part of the overall Unisys Publishing 
Solutions environment. 



6 



HE70-FS-HPAEA 



Unisys Proprietary 



Hermes Palette Availability In External Applications 



3 Functional Description 

In order to support the integration of third party applications with the suite of Hermes 
tools, third party applications will be provided with the capability to access contents 
stored in the Hermes database through a palette. The Hermes palette will gather a set of 
functions which will allow users to specify a query for objects/pages and to take further 
actions after objects/pages retrieval. 

3.1 Hermes palette functions 
3.1.1 Description 

The tool palette will provide access to the Hermes database and to the functions 
detailed below. 

• Search - This function will allow users to perform a query on the Hermes database 
in order to search for objects and pages. Users will be able to specify the search 
criteria in order to narrow down the query, thus allowing a fast and easy retrieval of 
the items being searched. The following fields can be used as search parameters: 

> Object/page name 

> Level In Hermes, up to 5 levels are available. This will be supported also 
when performing a query from external applications. 

> Publication date 

> Author 

> Status 

> Type. Users will be able to retrieve either external objects (pages created 
with the application that starts the query), or Hermes objects (texts, 
headlines, captions, summaries, charts, logos, graphs). As far as pages are 
concerned, users will be able to search for external pages only. 

> Object/page comment 

> Edition 

> Creator/modifier name and creation/modification intervals 

> Workflow fields. Users will be able to specify if the object/page being 
retrieved is used/not used, and the status in which the item is found. 

As the search function is also available via menu item, details on the above- 
mentioned search criteria will be provided in the HE70-FS-AQTPA document. 

After retrieval, query results will be displayed in the tool palette. Users will be 
able to choose which fields pertaining to the retrieved objects/pages will be 
displayed. These fields will be configurable. 

In addition, users will be able to take further actions (which are described below) 
on the retrieved objects/pages directly from the query results list. 
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• Open object/page — This function will allow users to open the retrieved external 
item by dragging&dropping it in its native application main screen. The UPS 
database will be updated, so that the item is marked as "locked". Users will then be 
able to modify the object/page according to their needs using the tools provided by 
the originating application. 

• Link object to page - This function will allow users to paginate retrieved objects 
into external pages (pages created with the external application that started the 
query through the Hermes palette). Retrieved objects can be paginated into the 
external page directly from the query results. The selected object will be paginated, 
provided that it is not already linked to another page. If this is the case, a warning 
message will be displayed and the link operation will fail. It will be possible to 
paginate objects created with the external application (for example InCopy texts 
will be paginated into InDesign pages), or Newsroom objects. If a Newsroom text 
is linked to an external page, an appropriate conversion will take place (see 
NewsRoom text import function described below). 

• Unlink object - This function will allow users to unlink an object previously 
linked to a page. This operation can be performed by selecting the object in the 
query results list and choosing the appropriate function. After the unlink action is 
taken, the object will be marked as "available" in the database. 

• Delete object/page — This function will allow users to delete a retrieved 
page/object directly from the query results. After the object/page deletion, the UPS 
database will be updated, so that the object/page is marked as "deleted". 

• Unlock object/page - This function will allow users to unlock an object/page 
already in use by another user. This action will be taken directly from the query 
results list. 

• NewsRoom text import into an external object/page - Users will be able to 
select a NewsRoom textual object retrieved with the Hermes palette and import the 
object content into an external object/page open in its native application. 

For example, when dragging the retrieved NewsRoom textual object into InCopy, 
the external application will generate a new InCopy object and import a flat version 
of the Newsroom text, without markup commands and text styles and convert the 
text into a new external object. 

When users drag and drop a Newsroom textual object into an external page (for 
example an InDesign page), a new external text object (InCopy, for example) will 
be created with the content read from the Newsroom object. 

• Copy/Move objects/pages among levels - This function will allow users to select 
an object/page from the query results list and copy or move it to a level different 
from that where it is currently found. Users will be able to select a new destination 
level from a dialog window that will be displayed when selecting this function. 
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4 Information for User Manual 

This functional specification, once approved, will be used by the technical writers to 
create the updates for the User Manual. 

5 Performance 

5.1 Speed 

There will not be degradation in speed due to the implementation of this enhancement. 

5.2 Reliability, Availability and Maintainability 

There will not be degradation in reliability, availability and/or maintainability due to 
the implementation of this enhancement. 

5.3 Capacity 

There will not be degradation in capacity due to the implementation of this 
enhancement. 



6 Installation 

Not applicable, as this is an enhancement request to an existing product with 
established installation and trouble-shooting procedures. 
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1 References 



This functional specification refers to Third Parties Integration with Hermes Explorer 
project. 



2 Functional Overview 

The integration of third parties applications with the Hermes applications will imply 
some changes in the Hermes Explorer module, in order to allow queries on the Hermes 
database to retrieve objects/pages created with external applications. 

2.1 Major functions 

• Capability to query the Hermes database to search for objects/pages created with 
third parties applications. 

• Capability to open the retrieved external objects/pages through the standard 
opening methods provided by the Hermes Explorer module. 



2.2 Data/Activity Diagram 
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2.3 Assumptions and Dependencies 

• The figures depicted in this document are dummy screenshots. 

• The GUI of all new dialog windows/controls implemented must be XP-like style, 

2.4 Migration, Compatibility and Co-existence 

This functionality will be implemented as part of the overall Unisys Publishing 
Solutions environment. 

New functionality must remain compatible with prior versions of software. 



6 



HE70-FS-TPIHE 



Unisys Proprietary 



Third Parties Integration with Hermes Explorer 



3 Functional Description 

The integration of third parties applications with the Hermes editorial systems requires 
the Hermes modules to be partially modified in order to interact with external 
applications. ' 
This project aims at providing users with the capabilities to query the Hermes database 
. using the Explorer module in order to retrieve object/pages created with external 
applications (for example: Adobe InDesign and InCopy). The retrieved objects/pages 
can then be opened using the Hermes Explorer standard opening methods. 



3.1 Searching for external objects 
3.1.1 Description 

Users will be able to query the Hermes database using Hermes Explorer to search for 
objects created with third parties applications. 

This will imply the capability to specify the object type to be retrieved in the search 
criteria. To achieve this, the Search Objects dialog window will be modified. 
In addition to the standard object types listed in the Name tab, a check box will be 
available, so that users are able to specify whether they want to retrieve external 
objects or not. 

Figure 1 - External object types availability for objects query 



Search objects 
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By checking this box, a combo box will be enabled listing the external object types 
according td their native application. Users will have the capability to select the object 
type coming either from specific external applications (multi-selection allowed) or 
from all the third parties applications integrated with the Hermes editorial system. 
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3.2 Searching for external pages 
3.2.1 Description 
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3.3 Opening retrieved external items 
3.3.1 Description 

Once retrieved from the Hermes database, the objects/pages created with third parties 
applications will be opened using the Hermes Explorer standard opening methods. 
Users will be able to open the external object/page either by double clicking on the 
record displayed in the Hermes Explorer Object pane, or by right-clicking the selected 
record in the Browse pane. The latter option will display a popup menu that, through 
the Open mode menu item, will allow users to select the application the object/page 
must be open with. As an alternative, it will be possible to double click the selected 
object/page in the Browse window while pressing the Ctrl key. The object/page will be 
directly open in its native application. 



Figure 4 —Opening external objects/pages 



% Unisys UPS Explorer - Active domoin: HERME560 User: 
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4 Information for User Manual 

This functional specification, once approved, will be used by the technical writers to 
create the updates for the User Manual. 

5 Performance 

5.1 Speed 

There will not be degradation in speed due to the implementation of this enhancement 

5.2 Reliability, Availability and Maintainability 

There will not be degradation in reliability, availability and/or maintainability due to 
the implementation of this enhancement 

5.3 Capacity 

There will not be degradation in capacity due to the implementation of this 
enhancement. 



6 Installation 

Not applicable, as this is an enhancement request to an existing product with 
established installation and trouble-shooting procedures. 
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